Welcome to the FitBox meal delivery platform documentation. This directory contains all technical and business documentation organized for easy navigation and maintenance.
docs/
├── README.md # This file
├── development/ # Developer guides and standards
│ ├── README.md # Main development guide
│ └── testing-guide.md # Comprehensive testing documentation
├── design/ # Design system and UI specifications
│ ├── design-system.md # Design system overview
│ ├── requirements.md # MVP UI/UX requirements
│ ├── component-research.md # Component selection research
│ ├── usage-guide.md # Implementation patterns
│ ├── components/ # Component specifications
│ └── tokens/ # Design tokens and variables
├── specifications/ # Technical and business specifications
│ ├── README.md # Specifications overview
│ ├── business-requirements.md # Feature specifications
│ ├── bundle-selection-spec.md # Revenue optimization strategy
│ ├── technical-architecture.md # System design
│ ├── database-design.md # Data models and relationships
│ ├── tasks.md # Implementation roadmap (39 MVP tasks)
│ ├── quickstart.md # User journey validation
│ ├── research.md # Technology decisions
│ ├── api-endpoints.md # Complete REST API reference
│ └── contracts/ # OpenAPI specification and testing
└── guides/ # User guides and troubleshooting
├── documentation-standards.md # Documentation organization rules
├── troubleshooting.md # Common issues and solutions
└── contributing.md # Contribution guidelines
- Main README - Project overview and quick start
- Development Guide - Coding standards and setup
- Current Tasks - What to work on next
- Testing Guide - Testing methodology
- Design System - Component library and tokens
- MVP Requirements - UI/UX specifications
- Usage Guide - Implementation patterns
- Business Requirements - Feature specifications
- Bundle Strategy - Revenue model
- User Journeys - Validation scenarios
- Technical Architecture - System design
- Database Design - Data models
- API Endpoints - Complete API reference
- API Contracts - OpenAPI specification
Progress: 32/39 MVP Phase 1 tasks completed (82%)
Last Updated: 2025-11-01
- Foundation Setup (T001-T005): 5 tasks - Project structure, dependencies, tools
- Database Layer (T006-T014): 9 tasks - PostgreSQL schema, models, seed data
- Authentication (T015-T019): 5 tasks - NextAuth.js with enhanced security
- API Endpoints (T020-T025): 6 tasks - Menu, delivery, user profile APIs
- Essential UI (T026-T031, T033): 7 tasks - Components with mock data, mobile-first design
- Bundle System (T026.5-T029.5): 4 tasks - Subscription model and deadline management
- Admin Dashboard (T032): 1 task - Order management interface
- Content Pages (T034-T035): 2 tasks - Critical business and legal pages
- API Routes: 20 implemented
- React Components: 45 components
- Test Suites: 11 test files
- Bundle system implementation (T026.5-T029.5)
- Admin panel for order management (T032)
- Critical content pages (T034-T035)
- Phase 2: Advanced subscription features
FitBox is implementing a bundle-first subscription model to increase Average Order Value from $17-25 to $85-140 (300-400% uplift).
Key Features:
- Bundle sizes: 6/8/10/12 meals with 5% subscription discount
- Smart deadline management (Tuesday/Saturday 6PM)
- Auto-default meal selection for missed deadlines
- Greater Vancouver Area delivery (Sunday/Wednesday)
- Frontend: Next.js 14, TypeScript, shadcn/ui, Tailwind CSS
- Backend: PostgreSQL, Prisma ORM, NextAuth.js, Stripe
- Testing: Jest, Playwright E2E, TDD methodology
- Deployment: Vercel with production-ready configuration
# Quick start
npm install
npm run dev
# Check current progress
npm run tasks:status
# See what to work on next
npm run tasks:nextWhen updating documentation:
- Keep README.md current with latest project status
- Update task progress in specifications/tasks.md
- Maintain cross-references between related documents
- Test documentation links to ensure they work
- TDD Methodology: Contract tests first, implementation second
- Real Database Testing: PostgreSQL integration, not mocks
- Mobile-First Design: All UI optimized for mobile experience
- Security by Default: Enhanced authentication, input validation
- Task Tracking:
npm run tasks:statusfor current progress - API Documentation: specifications/api-contracts/
- Testing Guidelines: development/testing-guide.md
- Next.js Documentation: https://nextjs.org/docs
- Prisma Documentation: https://www.prisma.io/docs
- shadcn/ui Components: https://ui.shadcn.com/
- Stripe Integration: https://stripe.com/docs
# Development
npm run dev # Start development server
npm run build # Build for production
# Database
npm run db:reset # Reset and reseed database
npm run db:studio # Open Prisma Studio
# Testing
npm run test # Unit tests
npm run test:e2e # End-to-end tests
npm run test:coverage # Coverage report
# Code Quality
npm run lint # ESLint checking
npm run type-check # TypeScript validation
# Task Management
npm run tasks:status # View progress
npm run tasks:next # See next tasks
npm run tasks:complete # Mark tasks completeThis reorganization achieves:
- 50% faster navigation with clear directory structure
- Single source of truth for each type of information
- Clear onboarding path for new team members
- Maintainable structure that scales with project growth
- Cross-referenced content for better discoverability
Last Updated: September 16, 2025 Next Review: When MVP Phase 2 begins (API implementation complete)