How ahmadsallaq6/codebuddyfinal works
Project Type and Purpose
• This is a full-stack web application (“CodeBuddy”) built with Next.js 14+ using the App Router.
• Purpose: An AI-powered learning platform connecting students and mentors, hosting interactive coding exercises, tracking progress, and providing AI-generated content & feedback.
File Structure
• Top-level:
• app/ – Next.js App Router routes, subdivided into auth, dashboard, admin, api
• components/ – Shared React UI components and shadcn/ui primitives under components/ui/
• contexts/, hooks/, providers/ – State management and custom hooks
• lib/, services/ – Business logic: interfaces to Firebase (auth, Firestore, storage), AI (Gemini), code evaluation
• public/, styles/, scripts/ – Static assets, global styles, DB seed scripts
• Config files: next.config.mjs, tailwind.config.ts, tsconfig.json
• Patterns:
• Next.js App Route (nested layouts, server vs client components)
• Context Providers wrapping the tree (auth-context, theme-provider)
• Service layer abstraction (lib/*-service.ts, services/*)
README Insights
• Tech stack: Next.js, TypeScript, Firebase Auth/Firestore/Storage, Tailwind + shadcn/ui, Gemini API, Monaco Editor.
• Features: Auth (students, mentors), Dashboard, Exercises (code editor, test runner), AI feedback, Social (messaging, leaderboard), Admin tools.
Final Advice
• Be comprehensive: break the system into all logical components (UI, contexts, hooks, server, services, DB).