# ashik-exe/careerlyst architecture

> Architecture diagram of the GitHub repository ashik-exe/careerlyst, 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/ashik-exe/careerlyst
- Repository: https://github.com/ashik-exe/careerlyst

## Overview

Formant is a career-services platform with public service discovery, client accounts and project dashboards, plus administrative operations. The principal journey is visitor → service discovery or lead assessment → signup/login → client dashboard for orders, messages, files and updates; staff use the admin panel to manage the service and project lifecycle. Demo state is stored locally, while Supabase is an optional configured backend. The graph follows explicit routes and source-index references; unsampled subsystem links are omitted or marked unverified.

Main entry points: [`src/lib/supabase.js`](https://github.com/ashik-exe/careerlyst/blob/main/src/lib/supabase.js) (Supabase client), [`src/main.jsx`](https://github.com/ashik-exe/careerlyst/blob/main/src/main.jsx) (Route application), [`src/components/DashboardShell.jsx`](https://github.com/ashik-exe/careerlyst/blob/main/src/components/DashboardShell.jsx) (Dashboard shell), [`src/pages/Admin.jsx`](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Admin.jsx) (Admin control panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Public entry"]
  node_marketing["Marketing pages<br/>[Home.jsx]"]
  node_public_pages["Service &amp; info pages<br/>[PublicPages.jsx]"]
  node_public_nav["Public navigation<br/>[PublicNav.jsx]"]
  node_assessment["Lead assessment<br/>[LeadAssessment.jsx]"]
end

subgraph group_client["Client experience"]
  node_auth["Signup &amp; login<br/>[Auth.jsx]"]
  node_dashboard["Client dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_admin["Admin operations"]
  node_admin_home["Admin control panel<br/>[Admin.jsx]"]
  node_admin_leads["Lead management<br/>[AdminLeads.jsx]"]
  node_admin_services["Service management<br/>[AdminServices.jsx]"]
  node_admin_projects["Project management<br/>[AdminProjects.jsx]"]
  node_admin_workspace["Team workspace<br/>[AdminWorkspace.jsx]"]
  node_admin_reviews["Review management<br/>[AdminReviews.jsx]"]
  node_admin_notifications["Notification management"]
  node_admin_settings["Admin settings<br/>[AdminSettings.jsx]"]
end

subgraph group_platform["Shared platform"]
  node_app["Route application<br/>[main.jsx]"]
  node_guard["Access guard<br/>[Protected.jsx]"]
  node_dashboard_shell["Dashboard shell<br/>[DashboardShell.jsx]"]
  node_local_store[("Demo state store<br/>[store.js]")]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_push["Push delivery function<br/>[index.ts]"]
  node_push_client["Push notification client"]
end

node_visitor(("Visitor / client"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_marketing
node_app -->|"routes to"| node_public_pages
node_app -->|"routes to"| node_assessment
node_app -->|"routes to"| node_auth
node_app -->|"protects routes"| node_guard
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_admin_home
node_app -->|"routes to"| node_admin_leads
node_app -->|"routes to"| node_admin_reviews
node_public_pages -->|"uses navigation"| node_public_nav
node_marketing -->|"uses navigation"| node_public_nav
node_auth -->|"updates demo state"| node_local_store
node_auth -->|"authenticates with"| node_supabase_client
node_public_nav -->|"signs out through"| node_supabase_client
node_guard -->|"checks session"| node_supabase_client
node_guard -->|"reads state"| node_local_store
node_dashboard -->|"renders shell"| node_dashboard_shell
node_dashboard -->|"reads state"| node_local_store
node_dashboard -->|"uses backend"| node_supabase_client
node_dashboard -->|"uses notifications"| node_push_client
node_dashboard_shell -->|"loads state"| node_local_store
node_dashboard_shell -->|"loads account data"| node_supabase_client
node_admin_home -->|"renders shell"| node_dashboard_shell
node_admin_home -->|"imports services"| node_admin_services
node_admin_home -->|"imports projects"| node_admin_projects
node_admin_home -->|"imports reviews"| node_admin_reviews
node_admin_home -->|"imports notifications"| node_admin_notifications
node_admin_home -->|"imports settings"| node_admin_settings
node_admin_leads -->|"renders shell"| node_dashboard_shell
node_admin_leads -->|"uses backend"| node_supabase_client
node_admin_services -->|"renders shell"| node_dashboard_shell
node_admin_services -->|"reads and writes"| node_supabase_client
node_admin_projects -->|"renders shell"| node_dashboard_shell
node_admin_projects -->|"uses backend"| node_supabase_client
node_admin_workspace -->|"renders shell"| node_dashboard_shell
node_admin_workspace -->|"uses backend"| node_supabase_client
node_admin_reviews -->|"renders shell"| node_dashboard_shell
node_admin_reviews -->|"deletes reviews"| node_supabase_client
node_admin_notifications -->|"renders shell"| node_dashboard_shell
node_admin_notifications -->|"uses backend"| node_supabase_client
node_admin_settings -->|"renders shell"| node_dashboard_shell
node_admin_settings -->|"uses backend"| node_supabase_client
node_push_client -->|"uses backend"| node_supabase_client
node_push_client -.->|"invokes delivery"| node_push
node_supabase_client -.->|"optional backend mode"| node_local_store

click node_app "https://github.com/ashik-exe/careerlyst/blob/main/src/main.jsx"
click node_marketing "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Home.jsx"
click node_public_pages "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/PublicPages.jsx"
click node_public_nav "https://github.com/ashik-exe/careerlyst/blob/main/src/components/PublicNav.jsx"
click node_assessment "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/LeadAssessment.jsx"
click node_auth "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Auth.jsx"
click node_guard "https://github.com/ashik-exe/careerlyst/blob/main/src/components/Protected.jsx"
click node_dashboard "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Dashboard.jsx"
click node_dashboard_shell "https://github.com/ashik-exe/careerlyst/blob/main/src/components/DashboardShell.jsx"
click node_admin_home "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Admin.jsx"
click node_admin_leads "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminLeads.jsx"
click node_admin_services "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminServices.jsx"
click node_admin_projects "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminProjects.jsx"
click node_admin_workspace "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminWorkspace.jsx"
click node_admin_reviews "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminReviews.jsx"
click node_admin_notifications "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminNotifications.jsx"
click node_admin_settings "https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminSettings.jsx"
click node_local_store "https://github.com/ashik-exe/careerlyst/blob/main/src/lib/store.js"
click node_supabase_client "https://github.com/ashik-exe/careerlyst/blob/main/src/lib/supabase.js"
click node_push "https://github.com/ashik-exe/careerlyst/blob/main/supabase/functions/send-push-notification/index.ts"
click node_push_client "https://github.com/ashik-exe/careerlyst/blob/main/src/lib/pushNotifications.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_marketing,node_public_pages,node_public_nav,node_assessment,node_visitor toneBlue
class node_auth,node_dashboard toneAmber
class node_admin_home,node_admin_leads,node_admin_services,node_admin_projects,node_admin_workspace,node_admin_reviews,node_admin_notifications,node_admin_settings toneMint
class node_app,node_guard,node_dashboard_shell,node_local_store,node_supabase_client,node_push,node_push_client toneRose
```

## Components

### Public entry

- [Marketing pages](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [Service & info pages](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/PublicPages.jsx): `src/pages/PublicPages.jsx`
- [Public navigation](https://github.com/ashik-exe/careerlyst/blob/main/src/components/PublicNav.jsx): `src/components/PublicNav.jsx`
- [Lead assessment](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/LeadAssessment.jsx): `src/pages/LeadAssessment.jsx`

### Client experience

- [Signup & login](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Auth.jsx): `src/pages/Auth.jsx`
- [Client dashboard](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`

### Admin operations

- [Admin control panel](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/Admin.jsx): `src/pages/Admin.jsx`
- [Lead management](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminLeads.jsx): `src/pages/AdminLeads.jsx`
- [Service management](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminServices.jsx): `src/pages/AdminServices.jsx`
- [Project management](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminProjects.jsx): `src/pages/AdminProjects.jsx`
- [Team workspace](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminWorkspace.jsx): `src/pages/AdminWorkspace.jsx`
- [Review management](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminReviews.jsx): `src/pages/AdminReviews.jsx`
- [Notification management](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminNotifications.jsx): `src/pages/AdminNotifications.jsx`
- [Admin settings](https://github.com/ashik-exe/careerlyst/blob/main/src/pages/AdminSettings.jsx): `src/pages/AdminSettings.jsx`

### Shared platform

- [Route application](https://github.com/ashik-exe/careerlyst/blob/main/src/main.jsx): `src/main.jsx`
- [Access guard](https://github.com/ashik-exe/careerlyst/blob/main/src/components/Protected.jsx): `src/components/Protected.jsx`
- [Dashboard shell](https://github.com/ashik-exe/careerlyst/blob/main/src/components/DashboardShell.jsx): `src/components/DashboardShell.jsx`
- [Demo state store](https://github.com/ashik-exe/careerlyst/blob/main/src/lib/store.js): `src/lib/store.js`
- [Supabase client](https://github.com/ashik-exe/careerlyst/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- [Push delivery function](https://github.com/ashik-exe/careerlyst/blob/main/supabase/functions/send-push-notification/index.ts): `supabase/functions/send-push-notification/index.ts`
- [Push notification client](https://github.com/ashik-exe/careerlyst/blob/main/src/lib/pushNotifications.js): `src/lib/pushNotifications.js`

### Other components

- **Visitor / client**

## Connections

- Visitor / client → Route application: opens (evidence: `src/main.jsx`)
- Route application → Marketing pages: routes to (evidence: `src/main.jsx`)
- Route application → Service & info pages: routes to (evidence: `src/main.jsx`)
- Route application → Lead assessment: routes to (evidence: `src/main.jsx`)
- Route application → Signup & login: routes to (evidence: `src/main.jsx`)
- Route application → Access guard: protects routes (evidence: `src/main.jsx`)
- Route application → Client dashboard: routes to (evidence: `src/main.jsx`)
- Route application → Admin control panel: routes to (evidence: `src/main.jsx`)
- Route application → Lead management: routes to (evidence: `src/main.jsx`)
- Route application → Review management: routes to (evidence: `src/main.jsx`)
- Service & info pages → Public navigation: uses navigation (evidence: `src/pages/PublicPages.jsx`)
- Marketing pages → Public navigation: uses navigation (evidence: `src/pages/Home.jsx`)
- Signup & login → Demo state store: updates demo state (evidence: `src/pages/Auth.jsx`)
- Signup & login → Supabase client: authenticates with (evidence: `src/pages/Auth.jsx`)
- Public navigation → Supabase client: signs out through (evidence: `src/components/PublicNav.jsx`)
- Access guard → Supabase client: checks session (evidence: `src/components/Protected.jsx`)
- Access guard → Demo state store: reads state (evidence: `src/components/Protected.jsx`)
- Client dashboard → Dashboard shell: renders shell (evidence: `src/pages/Dashboard.jsx`)
- Client dashboard → Demo state store: reads state (evidence: `src/pages/Dashboard.jsx`)
- Client dashboard → Supabase client: uses backend (evidence: `src/pages/Dashboard.jsx`)
- Client dashboard → Push notification client: uses notifications (evidence: `src/pages/Dashboard.jsx`)
- Dashboard shell → Demo state store: loads state (evidence: `src/components/DashboardShell.jsx`)
- Dashboard shell → Supabase client: loads account data (evidence: `src/components/DashboardShell.jsx`)
- Admin control panel → Dashboard shell: renders shell (evidence: `src/pages/Admin.jsx`)
- Admin control panel → Service management: imports services (evidence: `src/pages/Admin.jsx`)
- Admin control panel → Project management: imports projects (evidence: `src/pages/Admin.jsx`)
- Admin control panel → Review management: imports reviews (evidence: `src/pages/Admin.jsx`)
- Admin control panel → Notification management: imports notifications (evidence: `src/pages/Admin.jsx`)
- Admin control panel → Admin settings: imports settings (evidence: `src/pages/Admin.jsx`)
- Lead management → Dashboard shell: renders shell (evidence: `src/pages/AdminLeads.jsx`)
- Lead management → Supabase client: uses backend (evidence: `src/pages/AdminLeads.jsx`)
- Service management → Dashboard shell: renders shell (evidence: `src/pages/AdminServices.jsx`)
- Service management → Supabase client: reads and writes (evidence: `src/pages/AdminServices.jsx`)
- Project management → Dashboard shell: renders shell (evidence: `src/pages/AdminProjects.jsx`)
- Project management → Supabase client: uses backend (evidence: `src/pages/AdminProjects.jsx`)
- Team workspace → Dashboard shell: renders shell (evidence: `src/pages/AdminWorkspace.jsx`)
- Team workspace → Supabase client: uses backend (evidence: `src/pages/AdminWorkspace.jsx`)
- Review management → Dashboard shell: renders shell (evidence: `src/pages/AdminReviews.jsx`)
- Review management → Supabase client: deletes reviews (evidence: `src/pages/AdminReviews.jsx`)
- Notification management → Dashboard shell: renders shell (evidence: `src/pages/AdminNotifications.jsx`)
- Notification management → Supabase client: uses backend (evidence: `src/pages/AdminNotifications.jsx`)
- Admin settings → Dashboard shell: renders shell (evidence: `src/pages/AdminSettings.jsx`)
- Admin settings → Supabase client: uses backend (evidence: `src/pages/AdminSettings.jsx`)
- Push notification client → Supabase client: uses backend (evidence: `src/lib/pushNotifications.js`)
- Push notification client → Push delivery function: invokes delivery
- Supabase client → Demo state store: optional backend mode
