# ajay9084/path-pilot architecture

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

- Interactive diagram: https://gitdiagram.com/ajay9084/path-pilot
- Repository: https://github.com/ajay9084/path-pilot

## Overview

PathPilot is a career-growth web app offering industry insights, onboarding, interview preparation, resume building, and AI cover-letter pages. The user journey begins at the public site, proceeds through sign-in and profile setup, then into career tools; the dashboard retrieves or generates industry insights, while interview and resume workflows use separate server actions. Sampled code supports the dashboard, onboarding, interview, resume, and Inngest relationships; cover-letter implementation details were not sampled, so its connections are omitted.

Main entry points: [`app/(main)/resume/_components/resume-builder.jsx`](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/resume-builder.jsx) (Resume builder), [`lib/prisma.js`](https://github.com/ajay9084/path-pilot/blob/main/lib/prisma.js) (Prisma database), [`app/(main)/onboarding/page.jsx`](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/onboarding/page.jsx) (Onboarding route), [`app/(main)/onboarding/_components/onboarding-form.jsx`](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/onboarding/_components/onboarding-form.jsx) (Profile form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and identity"]
  node_landing["Public landing<br/>[page.jsx]"]
  node_hero["Landing hero<br/>[hero.jsx]"]
  node_header["Navigation and account<br/>[header.jsx]"]
  node_sign_in["Sign in<br/>[page.jsx]"]
  node_sign_up["Sign up<br/>[page.jsx]"]
end

subgraph group_profile["Profile setup"]
  node_onboarding_page["Onboarding route<br/>[page.jsx]"]
  node_onboarding_form["Profile form"]
  node_schema["Form schemas<br/>[schema.js]"]
  node_user_actions["User actions<br/>[user.js]"]
end

subgraph group_insights["Industry insights"]
  node_dashboard_page["Dashboard route<br/>[page.jsx]"]
  node_dashboard_view["Insights dashboard<br/>[dashboard-view.jsx]"]
  node_dashboard_actions["Industry insight actions<br/>[dashboard.js]"]
end

subgraph group_tools["Career tools"]
  node_interview_page["Interview preparation<br/>[page.jsx]"]
  node_interview_actions["Interview actions<br/>[interview.js]"]
  node_interview_components["Quiz and performance views"]
  node_resume_page["Resume route<br/>[page.jsx]"]
  node_resume_builder["Resume builder<br/>[resume-builder.jsx]"]
  node_resume_entries["Resume entry forms<br/>[entry-form.jsx]"]
  node_resume_pdf["Resume PDF renderer<br/>[Resume-PDF.jsx]"]
  node_resume_actions["Resume actions<br/>[resume.js]"]
  node_cover_letter["AI cover letter pages"]
end

subgraph group_runtime["Shared runtime"]
  node_fetch_hook["Async action hook<br/>[use-fetch.js]"]
  node_ui_primitives["UI primitives"]
  node_database[("Prisma database<br/>[prisma.js]")]
  node_inngest_route["Inngest endpoint<br/>[route.js]"]
  node_inngest_client["Inngest client<br/>[client.js]"]
  node_inngest_functions["Insight job<br/>[function.js]"]
end

node_visitor(("Career seeker"))
node_clerk["Clerk identity"]
node_gemini["Gemini AI"]

node_visitor -->|"opens"| node_landing
node_landing -->|"renders"| node_hero
node_landing -.->|"shows"| node_header
node_header -->|"authenticates"| node_clerk
node_visitor -->|"signs in"| node_sign_in
node_visitor -->|"signs up"| node_sign_up
node_sign_in -.->|"uses identity"| node_clerk
node_sign_up -.->|"uses identity"| node_clerk
node_visitor -->|"opens"| node_onboarding_page
node_onboarding_page -->|"renders"| node_onboarding_form
node_onboarding_page -->|"loads user"| node_user_actions
node_onboarding_form -->|"validates with"| node_schema
node_onboarding_form -->|"submits through"| node_fetch_hook
node_onboarding_form -->|"updates profile"| node_user_actions
node_onboarding_page -.->|"uses controls"| node_ui_primitives
node_user_actions -->|"reads and writes"| node_database
node_visitor -->|"opens"| node_dashboard_page
node_dashboard_page -->|"loads insights"| node_dashboard_actions
node_dashboard_page -->|"loads user"| node_user_actions
node_dashboard_page -->|"renders"| node_dashboard_view
node_dashboard_actions -->|"reads and writes"| node_database
node_dashboard_actions -->|"generates insights"| node_gemini
node_visitor -->|"opens"| node_interview_page
node_interview_page -->|"loads assessments"| node_interview_actions
node_interview_page -->|"renders"| node_interview_components
node_interview_actions -->|"uses database"| node_database
node_visitor -->|"opens"| node_resume_page
node_resume_page -->|"loads resume"| node_resume_actions
node_resume_page -->|"renders"| node_resume_builder
node_resume_builder -->|"saves resume"| node_resume_actions
node_resume_builder -->|"renders forms"| node_resume_entries
node_resume_builder -->|"renders PDF"| node_resume_pdf
node_resume_builder -->|"validates with"| node_schema
node_resume_actions -->|"uses database"| node_database
node_resume_builder -->|"wraps save action"| node_fetch_hook
node_visitor -.->|"opens"| node_cover_letter
node_inngest_route -->|"serves functions"| node_inngest_client
node_inngest_route -->|"registers job"| node_inngest_functions
node_inngest_functions -->|"uses client"| node_inngest_client
node_inngest_functions -->|"uses database"| node_database

click node_landing "https://github.com/ajay9084/path-pilot/blob/main/app/page.jsx"
click node_hero "https://github.com/ajay9084/path-pilot/blob/main/components/hero.jsx"
click node_header "https://github.com/ajay9084/path-pilot/blob/main/components/header.jsx"
click node_sign_in "https://github.com/ajay9084/path-pilot/blob/main/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.jsx"
click node_sign_up "https://github.com/ajay9084/path-pilot/blob/main/app/(auth)/sign-up/%5B%5B...sign-up%5D%5D/page.jsx"
click node_onboarding_page "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/onboarding/page.jsx"
click node_onboarding_form "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/onboarding/_components/onboarding-form.jsx"
click node_schema "https://github.com/ajay9084/path-pilot/blob/main/app/lib/schema.js"
click node_user_actions "https://github.com/ajay9084/path-pilot/blob/main/actions/user.js"
click node_dashboard_page "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/dashboard/page.jsx"
click node_dashboard_view "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/dashboard/_components/dashboard-view.jsx"
click node_dashboard_actions "https://github.com/ajay9084/path-pilot/blob/main/actions/dashboard.js"
click node_interview_page "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/interview/page.jsx"
click node_interview_actions "https://github.com/ajay9084/path-pilot/blob/main/actions/interview.js"
click node_interview_components "https://github.com/ajay9084/path-pilot/tree/main/app/(main)/interview/_component"
click node_resume_page "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/page.jsx"
click node_resume_builder "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/resume-builder.jsx"
click node_resume_entries "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/entry-form.jsx"
click node_resume_pdf "https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/Resume-PDF.jsx"
click node_resume_actions "https://github.com/ajay9084/path-pilot/blob/main/actions/resume.js"
click node_cover_letter "https://github.com/ajay9084/path-pilot/tree/main/app/(main)/ai-cover-letter"
click node_fetch_hook "https://github.com/ajay9084/path-pilot/blob/main/hooks/use-fetch.js"
click node_ui_primitives "https://github.com/ajay9084/path-pilot/tree/main/components/ui"
click node_database "https://github.com/ajay9084/path-pilot/blob/main/lib/prisma.js"
click node_inngest_route "https://github.com/ajay9084/path-pilot/blob/main/app/api/inngest/route.js"
click node_inngest_client "https://github.com/ajay9084/path-pilot/blob/main/lib/inngest/client.js"
click node_inngest_functions "https://github.com/ajay9084/path-pilot/blob/main/lib/inngest/function.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_landing,node_hero,node_header,node_sign_in,node_sign_up toneBlue
class node_onboarding_page,node_onboarding_form,node_schema,node_user_actions toneAmber
class node_dashboard_page,node_dashboard_view,node_dashboard_actions toneMint
class node_interview_page,node_interview_actions,node_interview_components,node_resume_page,node_resume_builder,node_resume_entries,node_resume_pdf,node_resume_actions,node_cover_letter toneRose
class node_fetch_hook,node_ui_primitives,node_database,node_inngest_route,node_inngest_client,node_inngest_functions,node_visitor,node_clerk,node_gemini toneIndigo
```

## Components

### Entry and identity

- [Public landing](https://github.com/ajay9084/path-pilot/blob/main/app/page.jsx): `app/page.jsx`
- [Landing hero](https://github.com/ajay9084/path-pilot/blob/main/components/hero.jsx): `components/hero.jsx`
- [Navigation and account](https://github.com/ajay9084/path-pilot/blob/main/components/header.jsx): `components/header.jsx`
- [Sign in](https://github.com/ajay9084/path-pilot/blob/main/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.jsx): `app/(auth)/sign-in/[[...sign-in]]/page.jsx`
- [Sign up](https://github.com/ajay9084/path-pilot/blob/main/app/(auth)/sign-up/%5B%5B...sign-up%5D%5D/page.jsx): `app/(auth)/sign-up/[[...sign-up]]/page.jsx`

### Profile setup

- [Onboarding route](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/onboarding/page.jsx): `app/(main)/onboarding/page.jsx`
- [Profile form](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/onboarding/_components/onboarding-form.jsx): `app/(main)/onboarding/_components/onboarding-form.jsx`
- [Form schemas](https://github.com/ajay9084/path-pilot/blob/main/app/lib/schema.js): `app/lib/schema.js`
- [User actions](https://github.com/ajay9084/path-pilot/blob/main/actions/user.js): `actions/user.js`

### Industry insights

- [Dashboard route](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/dashboard/page.jsx): `app/(main)/dashboard/page.jsx`
- [Insights dashboard](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/dashboard/_components/dashboard-view.jsx): `app/(main)/dashboard/_components/dashboard-view.jsx`
- [Industry insight actions](https://github.com/ajay9084/path-pilot/blob/main/actions/dashboard.js): `actions/dashboard.js`

### Career tools

- [Interview preparation](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/interview/page.jsx): `app/(main)/interview/page.jsx`
- [Interview actions](https://github.com/ajay9084/path-pilot/blob/main/actions/interview.js): `actions/interview.js`
- [Quiz and performance views](https://github.com/ajay9084/path-pilot/tree/main/app/(main)/interview/_component): `app/(main)/interview/_component`
- [Resume route](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/page.jsx): `app/(main)/resume/page.jsx`
- [Resume builder](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/resume-builder.jsx): `app/(main)/resume/_components/resume-builder.jsx`
- [Resume entry forms](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/entry-form.jsx): `app/(main)/resume/_components/entry-form.jsx`
- [Resume PDF renderer](https://github.com/ajay9084/path-pilot/blob/main/app/(main)/resume/_components/Resume-PDF.jsx): `app/(main)/resume/_components/Resume-PDF.jsx`
- [Resume actions](https://github.com/ajay9084/path-pilot/blob/main/actions/resume.js): `actions/resume.js`
- [AI cover letter pages](https://github.com/ajay9084/path-pilot/tree/main/app/(main)/ai-cover-letter): `app/(main)/ai-cover-letter`

### Shared runtime

- [Async action hook](https://github.com/ajay9084/path-pilot/blob/main/hooks/use-fetch.js): `hooks/use-fetch.js`
- [UI primitives](https://github.com/ajay9084/path-pilot/tree/main/components/ui): `components/ui`
- [Prisma database](https://github.com/ajay9084/path-pilot/blob/main/lib/prisma.js): `lib/prisma.js`
- [Inngest endpoint](https://github.com/ajay9084/path-pilot/blob/main/app/api/inngest/route.js): `app/api/inngest/route.js`
- [Inngest client](https://github.com/ajay9084/path-pilot/blob/main/lib/inngest/client.js): `lib/inngest/client.js`
- [Insight job](https://github.com/ajay9084/path-pilot/blob/main/lib/inngest/function.js): `lib/inngest/function.js`

### Other components

- **Career seeker**
- **Clerk identity**
- **Gemini AI**

## Connections

- Career seeker → Public landing: opens (evidence: `app/page.jsx`)
- Public landing → Landing hero: renders (evidence: `app/page.jsx`)
- Public landing → Navigation and account: shows
- Navigation and account → Clerk identity: authenticates (evidence: `components/header.jsx`)
- Career seeker → Sign in: signs in (evidence: `app/(auth)/sign-in/[[...sign-in]]/page.jsx`)
- Career seeker → Sign up: signs up (evidence: `app/(auth)/sign-up/[[...sign-up]]/page.jsx`)
- Sign in → Clerk identity: uses identity
- Sign up → Clerk identity: uses identity
- Career seeker → Onboarding route: opens (evidence: `app/(main)/onboarding/page.jsx`)
- Onboarding route → Profile form: renders (evidence: `app/(main)/onboarding/page.jsx`)
- Onboarding route → User actions: loads user (evidence: `app/(main)/onboarding/page.jsx`)
- Profile form → Form schemas: validates with (evidence: `app/(main)/onboarding/_components/onboarding-form.jsx`)
- Profile form → Async action hook: submits through (evidence: `app/(main)/onboarding/_components/onboarding-form.jsx`)
- Profile form → User actions: updates profile (evidence: `app/(main)/onboarding/_components/onboarding-form.jsx`)
- Onboarding route → UI primitives: uses controls
- User actions → Prisma database: reads and writes (evidence: `actions/user.js`)
- Career seeker → Dashboard route: opens (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard route → Industry insight actions: loads insights (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard route → User actions: loads user (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard route → Insights dashboard: renders (evidence: `app/(main)/dashboard/page.jsx`)
- Industry insight actions → Prisma database: reads and writes (evidence: `actions/dashboard.js`)
- Industry insight actions → Gemini AI: generates insights (evidence: `actions/dashboard.js`)
- Career seeker → Interview preparation: opens (evidence: `app/(main)/interview/page.jsx`)
- Interview preparation → Interview actions: loads assessments (evidence: `app/(main)/interview/page.jsx`)
- Interview preparation → Quiz and performance views: renders (evidence: `app/(main)/interview/page.jsx`)
- Interview actions → Prisma database: uses database (evidence: `actions/interview.js`)
- Career seeker → Resume route: opens (evidence: `app/(main)/resume/page.jsx`)
- Resume route → Resume actions: loads resume (evidence: `app/(main)/resume/page.jsx`)
- Resume route → Resume builder: renders (evidence: `app/(main)/resume/page.jsx`)
- Resume builder → Resume actions: saves resume (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Resume builder → Resume entry forms: renders forms (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Resume builder → Resume PDF renderer: renders PDF (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Resume builder → Form schemas: validates with (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Resume actions → Prisma database: uses database (evidence: `actions/resume.js`)
- Resume builder → Async action hook: wraps save action (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Career seeker → AI cover letter pages: opens
- Inngest endpoint → Inngest client: serves functions (evidence: `app/api/inngest/route.js`)
- Inngest endpoint → Insight job: registers job (evidence: `app/api/inngest/route.js`)
- Insight job → Inngest client: uses client (evidence: `lib/inngest/function.js`)
- Insight job → Prisma database: uses database (evidence: `lib/inngest/function.js`)
