feat: Phase 1 & 2 Complete - Code Cleanup, Testing & CI

.dockerignore

@@ -0,0 +1,12 @@
+node_modules/
+.next/
+frontend/
+.git/
+.github/
+.planning/
+data/
+assets/
+*.md
+.env
+.env.*
+!.env.example

.env.example

@@ -0,0 +1,10 @@
+# Database (Neon)
+DATABASE_URL=postgresql://user:password@host/dbname?sslmode=require
+
+# Backend (Railway)
+CORS_ORIGINS=https://your-app.vercel.app
+ENVIRONMENT=production
+LOG_LEVEL=INFO
+
+# Frontend (Vercel)
+NEXT_PUBLIC_API_URL=https://your-app.up.railway.app

.github/workflows/ci.yml

@@ -0,0 +1,99 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Run ruff
+        run: ruff check backend/
+
+  test-backend:
+    name: Test Backend
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          cd backend
+          pip install -r requirements.txt
+
+      - name: Run tests
+        run: |
+          cd backend
+          python -m pytest tests/ -v
+
+  test-frontend:
+    name: Test Frontend
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        run: |
+          cd frontend
+          npm ci
+
+      - name: Run lint
+        run: |
+          cd frontend
+          npm run lint
+
+      - name: Run tests
+        run: |
+          cd frontend
+          npm run test
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: [lint, test-backend, test-frontend]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install frontend dependencies
+        run: |
+          cd frontend
+          npm ci
+
+      - name: Build frontend
+        run: |
+          cd frontend
+          npm run build

.planning/INGEST-CONFLICTS.md

@@ -0,0 +1,59 @@
+# FocusFlow Ingest Conflicts
+
+## BLOCKERS (0)
+
+No blockers found. All decisions are consistent.
+
+## WARNINGS (0)
+
+No warnings found. No competing variants.
+
+## INFO (3)
+
+### INFO-001: Deployment Platform Choice
+- **Variant A:** Railway (backend + database)
+- **Variant B:** Fly.io (backend) + Neon (database)
+- **Variant C:** Vercel (frontend) + Railway (backend + database)
+- **Resolution:** User choice based on preference and pricing
+
+### INFO-002: Storage for Audio/Voice Notes
+- **Variant A:** Local filesystem (current)
+- **Variant B:** Object storage (S3-compatible)
+- **Variant C:** Cloudinary or similar
+- **Resolution:** Start with local filesystem, migrate to object storage if needed
+
+### INFO-003: Feature Priority
+- **Variant A:** Deploy first, add features later
+- **Variant B:** Complete all features, then deploy
+- **Variant C:** Deploy MVP, iterate on features
+- **Resolution:** User choice based on timeline and goals
+
+## Auto-Resolved (7)
+
+### AR-001: Backend Framework
+- **Input:** FastAPI (from codebase)
+- **Resolution:** LOCKED to FastAPI
+
+### AR-002: Frontend Framework
+- **Input:** Next.js 16 (from package.json)
+- **Resolution:** LOCKED to Next.js 16
+
+### AR-003: Database
+- **Input:** PostgreSQL (from docker-compose.yml)
+- **Resolution:** LOCKED to PostgreSQL 15
+
+### AR-004: Authentication
+- **Input:** None (from README)
+- **Resolution:** No authentication (local-only)
+
+### AR-005: Telemetry
+- **Input:** None (from README)
+- **Resolution:** No telemetry
+
+### AR-006: License
+- **Input:** MIT (from README)
+- **Resolution:** MIT license
+
+### AR-007: Test Framework
+- **Input:** Vitest + pytest (from package.json and README)
+- **Resolution:** Vitest for frontend, pytest for backend

.planning/PROJECT.md

@@ -0,0 +1,44 @@
+# FocusFlow Studio
+
+## Overview
+
+FocusFlow is a full-stack, local-first productivity app combining Pomodoro/Flowmodoro timers with Pranayama breathing exercises, kanban tasks, journaling, audio tracks, voice notes, and a whiteboard — all wrapped in 5 handcrafted themes. Zero telemetry, no accounts, runs entirely on your machine via Docker.
+
+## Goals
+
+- Ship a polished, deployable productivity app
+- Maintain local-first, zero-telemetry philosophy
+- Deploy to a public URL for portfolio demonstration
+- Clean up code, add missing features, and ensure production readiness
+
+## Non-Goals
+
+- User authentication / multi-user support
+- Cloud sync or backend-as-a-service
+- Mobile native apps (PWA acceptable)
+- Monetization
+
+## Tech Stack
+
+| Layer | Stack |
+|-------|-------|
+| Frontend | Next.js 16, React 19, Tailwind CSS 4, Framer Motion, Three.js |
+| Backend | Python 3.12, FastAPI, Psycopg2 |
+| Database | PostgreSQL 15 |
+| Container | Docker + Docker Compose |
+
+## Locked Decisions
+
+- **Runtime:** Docker Compose (local-first)
+- **Database:** PostgreSQL 15 (not SQLite, not Supabase)
+- **Backend framework:** FastAPI
+- **Frontend framework:** Next.js 16 with App Router
+- **No auth:** Local-only, no user accounts
+- **No telemetry:** Zero external analytics
+
+## Success Metrics
+
+- App runs via `docker compose up` with zero errors
+- All features functional and tested
+- Deployed to a public URL (Vercel + Railway/Fly.io or similar)
+- Portfolio-ready README with live demo link

.planning/REQUIREMENTS.md

@@ -0,0 +1,85 @@
+# FocusFlow Requirements
+
+## R1: Timer System
+- [x] Pomodoro timer (25/5 default)
+- [x] Flowmodoro (count-up with proportional breaks)
+- [x] Strict Mode (beforeunload trap)
+- [ ] Customizable timer durations
+- [ ] Timer persistence across page reloads
+
+## R2: Breathing Exercises
+- [x] Pranayama Ring (4-4-4 breathing guide)
+- [ ] Multiple breathing patterns (4-7-8, box breathing)
+- [ ] Breathing session logging
+
+## R3: Task Management
+- [x] Kanban task board
+- [x] Add/complete/delete tasks
+- [ ] Task categories/tags
+- [ ] Task reorder/drag-and-drop
+
+## R4: Session Analytics
+- [x] Focus score heatmap
+- [ ] Export analytics data
+- [ ] Weekly/monthly summaries
+
+## R5: Journal
+- [x] Timestamped journal entries
+- [ ] Rich text editing
+- [ ] Journal search
+- [ ] Journal export
+
+## R6: Audio Player
+- [x] Lo-fi, rain, forest ambiance
+- [ ] Volume control per track
+- [ ] Custom audio upload
+- [ ] Audio mixing (multiple tracks)
+
+## R7: Voice Notes (Vani)
+- [x] Record and store voice memos
+- [ ] Playback controls
+- [ ] Transcription
+- [ ] Voice note management (delete, rename)
+
+## R8: Whiteboard (Mandala)
+- [x] Freeform drawing canvas
+- [ ] Color picker
+- [ ] Save/load whiteboards
+- [ ] Export as image
+
+## R9: Wisdom Panel
+- [x] Rotating tips from Bhagavad Gita, Yoga Sutras & Ayurveda
+- [ ] User-expandable wisdom collection
+- [ ] Daily wisdom notification
+
+## R10: Themes
+- [x] Deep Space, Forest Zen, Cyberpunk, Vintage, Sattva
+- [ ] Theme persistence
+- [ ] Custom theme creation
+
+## R11: Production Readiness
+- [ ] Backend .dockerignore
+- [ ] Environment variable configuration
+- [ ] Error handling and logging
+- [ ] API rate limiting
+- [ ] Health check endpoints
+
+## R12: Deployment
+- [ ] Frontend deploy (Vercel/Netlify)
+- [ ] Backend deploy (Railway/Fly.io/Render)
+- [ ] Database hosting (Neon/Supabase/Railway)
+- [ ] CI/CD pipeline (GitHub Actions)
+- [ ] Custom domain setup
+
+## R13: Documentation
+- [ ] Comprehensive README with live demo link
+- [ ] API documentation (Swagger/OpenAPI)
+- [ ] Contributing guidelines
+- [ ] Architecture diagram
+
+## R14: Testing
+- [x] Frontend unit tests (Vitest)
+- [x] Backend API tests (pytest)
+- [ ] Integration tests
+- [ ] E2E tests
+- [ ] CI test automation