codeforgeai-io/codeforge-ai

Purpose and Runtime

CodeForge AI is a single full-stack coding-interview preparation platform: problem solving, code execution, frontend challenges, AI mentoring, contests, learning plans, community, billing, and administration. It runs as a Next.js 15 App Router application with React 19 and TypeScript, deployable to Vercel.

• Entrypoints: src/app/layout.tsx, src/app/page.tsx, src/middleware.ts

• Public, authenticated platform, and admin route surfaces are separated under src/app/, notably src/app/(platform)/layout.tsx and src/app/admin/layout.tsx.

Request Boundary, Auth, and API

Middleware is the first security boundary: session gating, public-route access, origin/CORS checks for mutations, and security headers. Route handlers implement the HTTP API; handlers should remain orchestration layers over schemas, auth/rate-limit utilities, and services.

• src/middleware.ts

• src/app/api/auth/me/route.ts

• src/lib/api-auth.ts

• src/lib/rate-limit.ts

Auth is Supabase-based with email/password, OAuth, and WebAuthn passkeys. Auth callback and passkey flows are explicit API endpoints.

• src/lib/supabase/server.ts

• src/lib/webauthn.ts

• src/app/api/auth/passkey/register/verify/route.ts

Product UI and Client State

The App Router pages compose feature modules into three major experiences: public marketing/content, the authenticated learning workspace, and back-office administration. Shared providers and navigation establish application-wide client concerns; workspace-local state uses Zustand.

• src/app/(platform)/dashboard/page.tsx

• src/components/providers.tsx

• src/features/workspace/workspace.tsx

• src/store/workspace.ts

Domain Services and Persistence

Business logic resides in src/services, decoupling API/UI from persistence and provider implementations. Supabase Postgres is the primary data system, modeled by SQL migrations and TypeScript models; Supabase Storage handles user and career uploads. data-backend preserves a module-selectable Mongo rollback path.

• src/services/questions.ts

• src/services/submissions.ts

• src/lib/data-backend.ts

• supabase/migrations/0001_init_core.sql

• src/models/User.ts

Core persisted domains include users/profiles, questions, submissions/progress, contests, discussions, subscriptions, AI usage, and spaced repetition.

Coding Execution Pipeline

DSA workspace and standalone compiler submit source, language, and stdin to server APIs. The execution service selects Paiza, Judge0, or self-hosted Piston at runtime, normalizes results, and lets submission flows persist outcomes and gamification effects.

• src/app/api/execute/route.ts

• src/app/api/compiler/route.ts

• src/services/execution/index.ts

• src/services/execution/normalize.ts

• src/services/execution/paiza.ts

This is an important external-trust boundary: code never executes in the Next.js process; it is delegated to configured execution providers.

AI, Learning, and Engagement Flows

AI routes accept workspace/tool context and delegate prompt orchestration and streaming model access to the AI service. Usage/credits and feature access constrain paid or metered capabilities. Learning outcomes feed analytics, weakness detection, revision, badges, and activity tracking.

• src/app/api/ai/chat/route.ts

• src/services/ai/groq.ts

• src/services/ai-credits.ts

• src/services/gamification/index.ts

• src/services/roadmaps.ts

Groq is the primary LLM integration; missing credentials should disable only AI capabilities.

Commerce, Operations, and External Infrastructure

Razorpay subscription handlers manage order, verification, cancellation, and webhooks; billing state is stored behind dedicated services. Admin pages and APIs operate content, users, submissions, prompts, campaigns, and reporting. Redis/Upstash supports rate limiting and hot leaderboard caching, with fallback behavior. PostHog and OpenTelemetry provide product analytics and observability.

• src/app/api/subscription/webhook/route.ts

• src/lib/razorpay.ts

• src/services/billing-store.ts

• src/app/api/admin/analytics/route.ts

• src/lib/redis.ts

• src/instrumentation.ts