How shivamchouhan7/syntiq-coding-platfrom works
Syntiq is a coding-practice platform: users discover problems, run or submit solutions, and track progress, with separate contest, profile, and AI-tool capabilities. The backend exposes Express routes backed by Supabase; code submissions are evaluated by the code runner before accepted results and progression data are recorded. Frontend routes and core backend flows are evidenced by excerpts and the SOURCE INDEX; some page-to-API links and unsampled controller behavior are documented only at the product level, so those links are marked unverified.
Main entry points: App.jsx Application routing · index.js Express API · supabase.js Supabase client · submissionController.js Submission and progression
Components 28
Web experience
- Application routing
frontend/src/App.jsx - Sign in / signup
frontend/src/pages/Login.jsx - Problem browser
frontend/src/pages/Dashboard.jsx - Problem workspace
frontend/src/pages/ProblemDetail.jsx - Problem authoring
frontend/src/pages/AdminAddProblem.jsx - Contest experience
frontend/src/pages/Contests.jsx - Contest detail
frontend/src/pages/ContestDetail.jsx - Leaderboard
frontend/src/pages/Leaderboard.jsx - User profile
frontend/src/pages/Profile.jsx
Backend API
- Express API
backend/src/index.js - Auth routes
backend/src/routes/auth.js - Problem routes
backend/src/routes/problems.js - Submission routes
backend/src/routes/submissions.js - Contest routes
backend/src/routes/contests.js - User routes
backend/src/routes/users.js - AI routes
backend/src/routes/ai.js - JWT validation
backend/src/middleware/authMiddleware.js
Practice services
- Authentication
backend/src/controllers/authController.js - Problem catalog
backend/src/controllers/problemController.js - Submission and progression
backend/src/controllers/submissionController.js - Code evaluation
backend/src/utils/codeRunner.js - Contest management
backend/src/controllers/contestController.js - Profiles and rankings
backend/src/controllers/userController.js - AI hints and analysis
backend/src/controllers/aiController.js
Persistence and AI
- Supabase client
backend/src/utils/supabase.js - Supabase PostgreSQL
- Google Gemini
Other components
- Learner / admin
Connections 43
- Learner / admin → Application routing: uses
README.md - Application routing → Sign in / signup: routes to
frontend/src/App.jsx - Application routing → Problem browser: routes to
frontend/src/App.jsx - Application routing → Problem workspace: routes to
frontend/src/App.jsx - Application routing → Problem authoring: routes to
frontend/src/App.jsx - Application routing → Contest experience: routes to
frontend/src/App.jsx - Application routing → Contest detail: routes to
frontend/src/App.jsx - Application routing → Leaderboard: routes to
frontend/src/App.jsx - Application routing → User profile: routes to
frontend/src/App.jsx - Application routing → Express API: validates session
frontend/src/App.jsx - Express API → Auth routes: mounts
backend/src/index.js - Express API → Problem routes: mounts
backend/src/index.js - Express API → Submission routes: mounts
backend/src/index.js - Express API → Contest routes: mounts
backend/src/index.js - Express API → User routes: mounts
backend/src/index.js - Express API → AI routes: mounts
backend/src/index.js - Auth routes → Authentication: dispatches
backend/src/routes/auth.js - Auth routes → JWT validation: guards session
backend/src/routes/auth.js - Problem routes → Problem catalog: dispatches
backend/src/routes/problems.js - Submission routes → Submission and progression: dispatches
backend/src/routes/submissions.js - Submission routes → JWT validation: guards session
backend/src/routes/submissions.js - Contest routes → Contest management: dispatches
backend/src/routes/contests.js - User routes → Profiles and rankings: dispatches
backend/src/routes/users.js - User routes → JWT validation: guards session
backend/src/routes/users.js - AI routes → AI hints and analysis: dispatches
backend/src/routes/ai.js - JWT validation → Supabase client: reads profiles
backend/src/middleware/authMiddleware.js - Authentication → Supabase client: reads and writes
backend/src/controllers/authController.js - Problem catalog → Supabase client: reads and writes
backend/src/controllers/problemController.js - Submission and progression → Supabase client: reads and writes
backend/src/controllers/submissionController.js - Submission and progression → Code evaluation: evaluates code
backend/src/controllers/submissionController.js - Contest management → Supabase client: reads and writes
backend/src/controllers/contestController.js - Profiles and rankings → Supabase client: reads and writes
backend/src/controllers/userController.js - Supabase client → Supabase PostgreSQL: connects
README.md - Sign in / signup → Authentication: authenticates
- Problem browser → Problem catalog: browses problems
- Problem workspace → Submission and progression: runs and submits
- Problem workspace → AI hints and analysis: requests AI help
- Problem authoring → Problem catalog: creates problems
- Contest experience → Contest management: browses contests
- Contest detail → Contest management: views contest
- Leaderboard → Profiles and rankings: loads rankings
- User profile → Profiles and rankings: loads profile
- AI hints and analysis → Google Gemini: requests generation