fiery-complete

byTarak Patil

Build a complete full-stack certification exam prep SaaS application with the following specifications: ## PRODUCT OVERVIEW Create "ExamPrep Pro" - a micro SaaS that helps users prepare for professional certification exams (like ISA Certified Arborist, PMP, AWS, etc.). The app provides practice questions, progress tracking, study schedules, and mock exams. ## TARGET USERS - Professionals preparing for certification exams with booked exam dates - Study groups and training centers - Individual learners who need structured prep ## CORE FEATURES ### 1. User Authentication & Onboarding - Email/password signup with email verification - Google OAuth login option - Onboarding flow: select exam type, set exam date, choose daily study time - User dashboard showing progress, streak, and next study session ### 2. Exam Selection & Setup - Browse available certification exams by category (IT, Project Management, Trades, Healthcare, etc.) - Each exam has: name, description, total questions, passing score, recommended study hours, price - Users can search and filter exams - After selecting an exam, users set their exam date and daily study goal ### 3. Practice Question Bank - Multiple choice questions (4 options, 1 correct answer) - Questions organized by topic/module - Each question includes: - Question text - 4 answer options - Correct answer with detailed explanation - Difficulty level (easy/medium/hard) - Topic tag - Users answer questions one at a time - Immediate feedback: show correct/incorrect with explanation - Bookmark questions for review ### 4. Adaptive Learning System - Track user performance by topic - Identify weak areas and prioritize those questions - Show confidence score for each topic (0-100%) - Recommend which topics to study next based on exam date and current progress ### 5. Mock Exams - Full-length practice exams that simulate real exam conditions - Timer countdown matching actual exam duration - Randomized question selection from question bank - Score report at end with: - Overall percentage - Pass/fail prediction - Breakdown by topic - Time spent per question - Questions to review ### 6. Study Schedule & Reminders - Auto-generated study plan based on: - Exam date - Total questions/topics - Daily study time preference - Daily study goals with progress tracking - Email reminders for missed study sessions - Streak counter to encourage daily practice ### 7. Progress Dashboard - Visual progress bar toward exam readiness - Topics mastered vs. topics needing work - Daily/weekly study activity chart - Mock exam score history - Predicted pass probability based on current performance ### 8. Payment & Subscription - Stripe integration for payments - Pricing tiers: - Free: 50 practice questions, 1 mock exam - Pro ($29/month or $99 one-time): unlimited questions, unlimited mock exams, all features - Subscription management page - Receipts via email ### 9. Admin Dashboard - Add/edit/delete exams and questions - Bulk import questions via CSV - View user analytics (signups, active users, revenue) - Manage subscriptions and refunds ## TECHNICAL REQUIREMENTS ### Frontend - React with TypeScript - Tailwind CSS for styling - Responsive design (mobile-first) - React Router for navigation - React Query for data fetching - Recharts for progress charts and analytics ### Backend - Node.js with Express - PostgreSQL database with Prisma ORM - JWT-based authentication - RESTful API architecture - Rate limiting and input validation ### Database Schema Create these tables: - users (id, email, password_hash, name, exam_date, daily_study_minutes, created_at) - exams (id, name, category, description, total_questions, passing_score, price, created_at) - questions (id, exam_id, topic, question_text, options JSON, correct_answer, explanation, difficulty, created_at) - user_progress (id, user_id, exam_id, topic, questions_answered, correct_count, last_studied) - bookmarks (id, user_id, question_id, created_at) - mock_exams (id, user_id, exam_id, score, topic_breakdown JSON, duration_seconds, created_at) - subscriptions (id, user_id, stripe_customer_id, stripe_subscription_id, status, current_period_end) ### API Endpoints - POST /api/auth/signup, /api/auth/login, /api/auth/logout - GET /api/exams, /api/exams/:id, /api/exams/:id/questions - POST /api/questions/:id/answer - GET /api/progress, /api/progress/by-topic - POST /api/mock-exams/start, /api/mock-exams/:id/submit - GET /api/study-plan - POST /api/webhooks/stripe (payment webhooks) ### Integrations - Stripe for payments (test mode initially) - SendGrid or Resend for transactional emails - PostgreSQL database (use connection string from environment) ## UI/UX DESIGN - Clean, modern interface with focus on readability - Color scheme: blue (#3B82F6) primary, green (#10B981) for success, red (#EF4444) for errors - Card-based layout with subtle shadows - Progress bars and circular progress indicators - Mobile-responsive navigation with hamburger menu - Loading states and error handling throughout ## PAGES TO BUILD 1. Landing page (hero, features, pricing, testimonials, CTA) 2. Signup/Login pages 3. User dashboard (main study interface) 4. Exam browser/search page 5. Exam detail page 6. Practice question interface 7. Mock exam interface with timer 8. Progress/analytics page 9. Study schedule page 10. Account settings & subscription management 11. Admin dashboard (exam/question management) 12. Payment success/failure pages ## DEPLOYMENT READY - Environment variables for database URL, Stripe keys, email API key, JWT secret - Docker configuration for easy deployment - Production build optimization - Error logging and monitoring setup ## START BUILDING Generate the complete application with all features, pages, components, API routes, database schema, and authentication. Make it production-ready with proper error handling, loading states, and responsive design. Include sample data for 3 certification exams with 50+ questions each for testing.