ConfAI Workshop Monorepo

Overview

This monorepo contains the full-stack implementation of a feature flag management system, including:

• Backend: TypeScript/Express API for feature flag management, history, and notes.
• Frontend: Next.js UI for creating, editing, and viewing feature flags.

---

Monorepo Structure

confai-workshop/
├── apps/
│   ├── backend/    # Express/TypeScript API
│   └── frontend/   # Next.js UI
├── backlog/        # Feature specs, user stories, and design docs
├── .gitignore      # Git ignore rules
├── package.json    # Root scripts and dependencies
├── README.md       # This file
└── ...

---

Prerequisites

• Node.js (v18+ recommended)
• npm (v9+ recommended)
• PostgreSQL (or Docker for DB)
• (Optional) Docker & Docker Compose for orchestration

---

Setup (All Apps)

1. Install dependencies (root and all apps):

   npm install
   cd apps/backend && npm install
   cd ../frontend && npm install
   cd ../..

2. Environment variables:

   • Copy .env.example to .env in each app and fill in required values.
   • Backend: DATABASE_URL, PORT
   • Frontend: NEXT_PUBLIC_API_URL

---

Running the Apps

With Docker Compose (if configured):

cd ./infra
docker-compose up --build

Development (separate terminals):

• Backend:

  cd apps/backend
  npm run dev

• Frontend:

  cd apps/frontend
  npm run dev

• Visit http://localhost:3000

---

Common Scripts (from root)

• npm run lint # Lint all apps
• npm run format # Format all apps
• npm test # Run all tests (if configured)

---

Documentation

• Backend README
• Frontend README

---

Contribution & Workflow

• Follow the dev workflow in the backlog and code review rules.
• All code must be TypeScript, strictly typed, and tested.
• See app-specific READMEs for more details.

---