# shivamchouhan7/syntiq-coding-platfrom architecture

> Architecture diagram of the GitHub repository shivamchouhan7/syntiq-coding-platfrom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shivamchouhan7/syntiq-coding-platfrom
- Repository: https://github.com/shivamchouhan7/syntiq-coding-platfrom

## Overview

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: [`frontend/src/App.jsx`](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/App.jsx) (Application routing), [`backend/src/index.js`](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/index.js) (Express API), [`backend/src/utils/supabase.js`](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/utils/supabase.js) (Supabase client), [`backend/src/controllers/submissionController.js`](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/submissionController.js) (Submission and progression)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_webapp["Application routing<br/>[App.jsx]"]
  node_authpages["Sign in / signup<br/>[Login.jsx]"]
  node_dashboard["Problem browser<br/>[Dashboard.jsx]"]
  node_problemui["Problem workspace<br/>[ProblemDetail.jsx]"]
  node_adminui["Problem authoring"]
  node_contestui["Contest experience<br/>[Contests.jsx]"]
  node_contestdetailui["Contest detail<br/>[ContestDetail.jsx]"]
  node_leaderboardui["Leaderboard<br/>[Leaderboard.jsx]"]
  node_profileui["User profile<br/>[Profile.jsx]"]
end

subgraph group_api["Backend API"]
  node_apiapp["Express API<br/>[index.js]"]
  node_authroutes["Auth routes<br/>[auth.js]"]
  node_problemroutes["Problem routes<br/>[problems.js]"]
  node_submissionroutes["Submission routes<br/>[submissions.js]"]
  node_contestroutes["Contest routes<br/>[contests.js]"]
  node_userroutes["User routes<br/>[users.js]"]
  node_airoutes["AI routes<br/>[ai.js]"]
  node_authguard["JWT validation<br/>[authMiddleware.js]"]
end

subgraph group_domain["Practice services"]
  node_authservice["Authentication<br/>[authController.js]"]
  node_problemservice["Problem catalog"]
  node_submissionservice["Submission and progression"]
  node_runner["Code evaluation<br/>[codeRunner.js]"]
  node_contestservice["Contest management"]
  node_userservice["Profiles and rankings<br/>[userController.js]"]
  node_aiservice["AI hints and analysis<br/>[aiController.js]"]
end

subgraph group_persistence["Persistence and AI"]
  node_supabaseclient["Supabase client<br/>[supabase.js]"]
  node_database[("Supabase PostgreSQL")]
  node_gemini["Google Gemini"]
end

node_coder(("Learner / admin"))

node_coder -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_authpages
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_problemui
node_webapp -->|"routes to"| node_adminui
node_webapp -->|"routes to"| node_contestui
node_webapp -->|"routes to"| node_contestdetailui
node_webapp -->|"routes to"| node_leaderboardui
node_webapp -->|"routes to"| node_profileui
node_webapp -->|"validates session"| node_apiapp
node_apiapp -->|"mounts"| node_authroutes
node_apiapp -->|"mounts"| node_problemroutes
node_apiapp -->|"mounts"| node_submissionroutes
node_apiapp -->|"mounts"| node_contestroutes
node_apiapp -->|"mounts"| node_userroutes
node_apiapp -->|"mounts"| node_airoutes
node_authroutes -->|"dispatches"| node_authservice
node_authroutes -->|"guards session"| node_authguard
node_problemroutes -->|"dispatches"| node_problemservice
node_submissionroutes -->|"dispatches"| node_submissionservice
node_submissionroutes -->|"guards session"| node_authguard
node_contestroutes -->|"dispatches"| node_contestservice
node_userroutes -->|"dispatches"| node_userservice
node_userroutes -->|"guards session"| node_authguard
node_airoutes -->|"dispatches"| node_aiservice
node_authguard -->|"reads profiles"| node_supabaseclient
node_authservice -->|"reads and writes"| node_supabaseclient
node_problemservice -->|"reads and writes"| node_supabaseclient
node_submissionservice -->|"reads and writes"| node_supabaseclient
node_submissionservice -->|"evaluates code"| node_runner
node_contestservice -->|"reads and writes"| node_supabaseclient
node_userservice -->|"reads and writes"| node_supabaseclient
node_supabaseclient -->|"connects"| node_database
node_authpages -.->|"authenticates"| node_authservice
node_dashboard -.->|"browses problems"| node_problemservice
node_problemui -.->|"runs and submits"| node_submissionservice
node_problemui -.->|"requests AI help"| node_aiservice
node_adminui -.->|"creates problems"| node_problemservice
node_contestui -.->|"browses contests"| node_contestservice
node_contestdetailui -.->|"views contest"| node_contestservice
node_leaderboardui -.->|"loads rankings"| node_userservice
node_profileui -.->|"loads profile"| node_userservice
node_aiservice -.->|"requests generation"| node_gemini

click node_webapp "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/App.jsx"
click node_authpages "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Login.jsx"
click node_dashboard "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Dashboard.jsx"
click node_problemui "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/ProblemDetail.jsx"
click node_adminui "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/AdminAddProblem.jsx"
click node_contestui "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Contests.jsx"
click node_contestdetailui "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/ContestDetail.jsx"
click node_leaderboardui "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Leaderboard.jsx"
click node_profileui "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Profile.jsx"
click node_apiapp "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/index.js"
click node_authroutes "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/auth.js"
click node_problemroutes "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/problems.js"
click node_submissionroutes "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/submissions.js"
click node_contestroutes "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/contests.js"
click node_userroutes "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/users.js"
click node_airoutes "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/ai.js"
click node_authservice "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/authController.js"
click node_problemservice "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/problemController.js"
click node_submissionservice "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/submissionController.js"
click node_runner "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/utils/codeRunner.js"
click node_contestservice "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/contestController.js"
click node_userservice "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/userController.js"
click node_aiservice "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/aiController.js"
click node_authguard "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/middleware/authMiddleware.js"
click node_supabaseclient "https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/utils/supabase.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_authpages,node_dashboard,node_problemui,node_adminui,node_contestui,node_contestdetailui,node_leaderboardui,node_profileui toneBlue
class node_apiapp,node_authroutes,node_problemroutes,node_submissionroutes,node_contestroutes,node_userroutes,node_airoutes,node_authguard toneAmber
class node_authservice,node_problemservice,node_submissionservice,node_runner,node_contestservice,node_userservice,node_aiservice toneMint
class node_supabaseclient,node_database,node_gemini toneRose
class node_coder toneIndigo
```

## Components

### Web experience

- [Application routing](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign in / signup](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Problem browser](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Problem workspace](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/ProblemDetail.jsx): `frontend/src/pages/ProblemDetail.jsx`
- [Problem authoring](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/AdminAddProblem.jsx): `frontend/src/pages/AdminAddProblem.jsx`
- [Contest experience](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Contests.jsx): `frontend/src/pages/Contests.jsx`
- [Contest detail](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/ContestDetail.jsx): `frontend/src/pages/ContestDetail.jsx`
- [Leaderboard](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Leaderboard.jsx): `frontend/src/pages/Leaderboard.jsx`
- [User profile](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`

### Backend API

- [Express API](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/index.js): `backend/src/index.js`
- [Auth routes](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [Problem routes](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/problems.js): `backend/src/routes/problems.js`
- [Submission routes](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/submissions.js): `backend/src/routes/submissions.js`
- [Contest routes](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/contests.js): `backend/src/routes/contests.js`
- [User routes](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/users.js): `backend/src/routes/users.js`
- [AI routes](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/routes/ai.js): `backend/src/routes/ai.js`
- [JWT validation](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`

### Practice services

- [Authentication](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Problem catalog](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/problemController.js): `backend/src/controllers/problemController.js`
- [Submission and progression](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/submissionController.js): `backend/src/controllers/submissionController.js`
- [Code evaluation](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/utils/codeRunner.js): `backend/src/utils/codeRunner.js`
- [Contest management](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/contestController.js): `backend/src/controllers/contestController.js`
- [Profiles and rankings](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/userController.js): `backend/src/controllers/userController.js`
- [AI hints and analysis](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/controllers/aiController.js): `backend/src/controllers/aiController.js`

### Persistence and AI

- [Supabase client](https://github.com/shivamchouhan7/syntiq-coding-platfrom/blob/main/backend/src/utils/supabase.js): `backend/src/utils/supabase.js`
- **Supabase PostgreSQL**
- **Google Gemini**

### Other components

- **Learner / admin**

## Connections

- Learner / admin → Application routing: uses (evidence: `README.md`)
- Application routing → Sign in / signup: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Problem browser: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Problem workspace: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Problem authoring: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Contest experience: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Contest detail: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Leaderboard: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → User profile: routes to (evidence: `frontend/src/App.jsx`)
- Application routing → Express API: validates session (evidence: `frontend/src/App.jsx`)
- Express API → Auth routes: mounts (evidence: `backend/src/index.js`)
- Express API → Problem routes: mounts (evidence: `backend/src/index.js`)
- Express API → Submission routes: mounts (evidence: `backend/src/index.js`)
- Express API → Contest routes: mounts (evidence: `backend/src/index.js`)
- Express API → User routes: mounts (evidence: `backend/src/index.js`)
- Express API → AI routes: mounts (evidence: `backend/src/index.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/src/routes/auth.js`)
- Auth routes → JWT validation: guards session (evidence: `backend/src/routes/auth.js`)
- Problem routes → Problem catalog: dispatches (evidence: `backend/src/routes/problems.js`)
- Submission routes → Submission and progression: dispatches (evidence: `backend/src/routes/submissions.js`)
- Submission routes → JWT validation: guards session (evidence: `backend/src/routes/submissions.js`)
- Contest routes → Contest management: dispatches (evidence: `backend/src/routes/contests.js`)
- User routes → Profiles and rankings: dispatches (evidence: `backend/src/routes/users.js`)
- User routes → JWT validation: guards session (evidence: `backend/src/routes/users.js`)
- AI routes → AI hints and analysis: dispatches (evidence: `backend/src/routes/ai.js`)
- JWT validation → Supabase client: reads profiles (evidence: `backend/src/middleware/authMiddleware.js`)
- Authentication → Supabase client: reads and writes (evidence: `backend/src/controllers/authController.js`)
- Problem catalog → Supabase client: reads and writes (evidence: `backend/src/controllers/problemController.js`)
- Submission and progression → Supabase client: reads and writes (evidence: `backend/src/controllers/submissionController.js`)
- Submission and progression → Code evaluation: evaluates code (evidence: `backend/src/controllers/submissionController.js`)
- Contest management → Supabase client: reads and writes (evidence: `backend/src/controllers/contestController.js`)
- Profiles and rankings → Supabase client: reads and writes (evidence: `backend/src/controllers/userController.js`)
- Supabase client → Supabase PostgreSQL: connects (evidence: `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
