QuitMaster

A smoking cessation platform with an API-first architecture designed for web and future mobile apps.

🎯 Project Overview

QuitMaster uses behavioral pressure, AI-driven guidance, and daily touchpoints to actively drive users to quit smoking - not just passively track their progress.

Core Principles

• API-first architecture - Backend is independent, ready for iOS/Android apps
• Behavioral pressure - Active intervention, not passive observation
• Daily touchpoints - Short sessions, consistent engagement
• Measurable progress - Everything is tracked and quantified
• Stage-based journey - Clear phases from preparation to freedom

🏗️ Architecture

quit_master/
├── frontend/          # Vue 3 web client
│   ├── src/
│   │   ├── components/
│   │   ├── App.vue
│   │   ├── main.js
│   │   └── style.css
│   └── package.json
│
├── backend/           # Express API server
│   ├── src/
│   │   ├── routes/
│   │   │   └── api.js
│   │   └── server.js
│   └── package.json
│
└── README.md

🚀 Getting Started

Prerequisites

• Node.js 18+ and npm

Installation

1. Clone and navigate to project

cd /Users/drakkar/Projects/quit_master

2. Install frontend dependencies

cd frontend
npm install

3. Install backend dependencies

cd ../backend
npm install

Running the Application

Terminal 1 - Frontend (Vue 3)

cd frontend
npm run dev

Frontend runs on: http://localhost:5173

Terminal 2 - Backend (Express API)

cd backend
npm start

Backend runs on: http://localhost:3001

Health Checks

• Frontend: http://localhost:5173
• Backend API: http://localhost:3001/health
• API Routes: http://localhost:3001/api/health

🎨 Design System

Color Palette (Health/Wellness Theme)

• Primary: Emerald Green (#10b981) - Growth, health, vitality
• Secondary: Cyan (#06b6d4) - Clarity, freshness, renewal
• Accent: Purple (#8b5cf6) - Transformation, change

Key Features

• Glassmorphism effects
• Smooth micro-animations
• Gradient orbs and backgrounds
• Mobile-first responsive design
• Modern typography (Inter font)

📱 Current Status

✅ Completed

• Landing page with conversion optimization
• Hero section with animated gradients
• How It Works (3-step process)
• Why QuitMaster Works (6 key features)
• Statistics section (health timeline)
• Testimonials (2 success stories)
• Final CTA section
• Backend API foundation
• Health check endpoints

🔜 Next Steps

1. Onboarding funnel
2. Quit plan creation
3. Daily stage flow
4. Progress tracking
5. Relapse handling
6. Database integration (PostgreSQL)
7. User authentication
8. Mobile app development

🔌 API Endpoints (Planned)

POST   /api/onboarding           - Submit onboarding questionnaire
POST   /api/quit-plan             - Generate personalized quit plan
GET    /api/quit-plan/:userId     - Get user's quit plan
POST   /api/tracking/daily        - Submit daily check-in
GET    /api/tracking/progress/:userId - Get user progress
POST   /api/tracking/craving      - Log a craving event
POST   /api/relapse               - Handle relapse recovery

🛠️ Technology Stack

• Frontend: Vue 3, Vite, Vanilla CSS
• Backend: Node.js, Express
• Database: PostgreSQL (future)
• Mobile: React Native / Flutter (future)

📄 License

MIT