# indianjobstech/portad-dashboard architecture

> Architecture diagram of the GitHub repository indianjobstech/portad-dashboard, 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/indianjobstech/portad-dashboard
- Repository: https://github.com/indianjobstech/portad-dashboard

## Overview

PortaD Dashboard is a public-facing Next.js frontend for a local-first SaaS workspace migration product; it does not ship migration logic. Users can explore the product, open a migration-wizard shell, inspect compatibility, view the jobs placeholder, and manage an account. The account flow supports Firebase authentication when configured and a browser-local preview session otherwise. The graph covers the documented dashboard capabilities and the sampled API-health and authentication wiring; unsampled migration internals and hosted job execution are not represented as implemented services.

Main entry points: [`src/app/page.tsx`](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/page.tsx) (Overview page), [`src/components/api-status.tsx`](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/api-status.tsx) (API health indicator), [`src/lib/auth.ts`](https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/auth.ts) (Session and auth), [`src/app/layout.tsx`](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/layout.tsx) (Shared app layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard routes"]
  node_home["Overview page<br/>[page.tsx]"]
  node_migration["Migration wizard shell<br/>[page.tsx]"]
  node_jobs["Jobs view<br/>[page.tsx]"]
  node_compatibility["Compatibility matrix<br/>[matrix.tsx]"]
  node_compatibility_route["Compatibility page<br/>[page.tsx]"]
  node_account["Account page<br/>[page.tsx]"]
  node_layout["Shared app layout<br/>[layout.tsx]"]
end

subgraph group_marketing["Product presentation"]
  node_landing_ui["Landing interactions<br/>[accordion.tsx]"]
  node_api_status["API health indicator<br/>[api-status.tsx]"]
  node_visuals["Hero and carousel<br/>[hero-visual.tsx]"]
  node_process["Process display<br/>[process.tsx]"]
  node_terminal["CLI demonstration<br/>[terminal.tsx]"]
  node_site_header["Site header<br/>[site-header.tsx]"]
  node_site_footer["Site footer<br/>[site-footer.tsx]"]
end

subgraph group_identity["Identity and configuration"]
  node_auth["Session and auth<br/>[auth.ts]"]
  node_firebase["Firebase adapter<br/>[firebase.ts]"]
  node_config["API configuration<br/>[config.ts]"]
  node_preview_storage[("Browser preview session<br/>[auth.ts]")]
end

subgraph group_integrations["External services"]
  node_api["PortaD API"]
  node_firebase_service["Firebase Auth service"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"opens"| node_migration
node_visitor -->|"opens"| node_jobs
node_visitor -->|"opens"| node_compatibility_route
node_visitor -->|"opens"| node_account
node_home -->|"renders"| node_landing_ui
node_home -->|"renders"| node_api_status
node_home -->|"renders"| node_visuals
node_home -->|"renders"| node_process
node_home -->|"renders"| node_terminal
node_compatibility_route -->|"renders"| node_compatibility
node_jobs -->|"links to"| node_migration
node_account -->|"uses"| node_auth
node_auth -->|"requests API"| node_firebase
node_auth -->|"reads and writes"| node_preview_storage
node_firebase -.->|"authenticates with"| node_firebase_service
node_api_status -->|"reads URL"| node_config
node_api_status -->|"probes health"| node_api
node_layout -->|"renders"| node_site_header
node_layout -->|"renders"| node_site_footer
node_site_footer -->|"renders"| node_api_status
node_site_header -->|"uses"| node_auth

click node_home "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/page.tsx"
click node_migration "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/migrate/page.tsx"
click node_jobs "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/jobs/page.tsx"
click node_compatibility "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/compatibility/matrix.tsx"
click node_compatibility_route "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/compatibility/page.tsx"
click node_account "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/account/page.tsx"
click node_layout "https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/layout.tsx"
click node_landing_ui "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/accordion.tsx"
click node_api_status "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/api-status.tsx"
click node_visuals "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/hero-visual.tsx"
click node_process "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/process.tsx"
click node_terminal "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/terminal.tsx"
click node_site_header "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/site-header.tsx"
click node_site_footer "https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/site-footer.tsx"
click node_auth "https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/auth.ts"
click node_firebase "https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/firebase.ts"
click node_config "https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/config.ts"
click node_preview_storage "https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/auth.ts"

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_home,node_migration,node_jobs,node_compatibility,node_compatibility_route,node_account,node_layout toneBlue
class node_landing_ui,node_api_status,node_visuals,node_process,node_terminal,node_site_header,node_site_footer toneAmber
class node_auth,node_firebase,node_config,node_preview_storage toneMint
class node_api,node_firebase_service toneRose
class node_visitor toneIndigo
```

## Components

### Dashboard routes

- [Overview page](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Migration wizard shell](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/migrate/page.tsx): `src/app/migrate/page.tsx`
- [Jobs view](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/jobs/page.tsx): `src/app/jobs/page.tsx`
- [Compatibility matrix](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/compatibility/matrix.tsx): `src/app/compatibility/matrix.tsx`
- [Compatibility page](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/compatibility/page.tsx): `src/app/compatibility/page.tsx`
- [Account page](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/account/page.tsx): `src/app/account/page.tsx`
- [Shared app layout](https://github.com/indianjobstech/portad-dashboard/blob/main/src/app/layout.tsx): `src/app/layout.tsx`

### Product presentation

- [Landing interactions](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/accordion.tsx): `src/components/accordion.tsx`
- [API health indicator](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/api-status.tsx): `src/components/api-status.tsx`
- [Hero and carousel](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/hero-visual.tsx): `src/components/hero-visual.tsx`
- [Process display](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/process.tsx): `src/components/process.tsx`
- [CLI demonstration](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/terminal.tsx): `src/components/terminal.tsx`
- [Site header](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/site-header.tsx): `src/components/site-header.tsx`
- [Site footer](https://github.com/indianjobstech/portad-dashboard/blob/main/src/components/site-footer.tsx): `src/components/site-footer.tsx`

### Identity and configuration

- [Session and auth](https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Firebase adapter](https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- [API configuration](https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/config.ts): `src/lib/config.ts`
- [Browser preview session](https://github.com/indianjobstech/portad-dashboard/blob/main/src/lib/auth.ts): `src/lib/auth.ts`

### External services

- **PortaD API**
- **Firebase Auth service**

### Other components

- **Visitor**

## Connections

- Visitor → Overview page: opens (evidence: `README.md`)
- Visitor → Migration wizard shell: opens (evidence: `README.md`)
- Visitor → Jobs view: opens (evidence: `README.md`)
- Visitor → Compatibility page: opens (evidence: `README.md`)
- Visitor → Account page: opens (evidence: `README.md`)
- Overview page → Landing interactions: renders (evidence: `src/app/page.tsx`)
- Overview page → API health indicator: renders (evidence: `src/app/page.tsx`)
- Overview page → Hero and carousel: renders (evidence: `src/app/page.tsx`)
- Overview page → Process display: renders (evidence: `src/app/page.tsx`)
- Overview page → CLI demonstration: renders (evidence: `src/app/page.tsx`)
- Compatibility page → Compatibility matrix: renders (evidence: `src/app/compatibility/page.tsx`)
- Jobs view → Migration wizard shell: links to (evidence: `src/app/jobs/page.tsx`)
- Account page → Session and auth: uses (evidence: `src/app/account/page.tsx`)
- Session and auth → Firebase adapter: requests API (evidence: `src/lib/auth.ts`)
- Session and auth → Browser preview session: reads and writes (evidence: `src/lib/auth.ts`)
- Firebase adapter → Firebase Auth service: authenticates with (evidence: `src/lib/firebase.ts`)
- API health indicator → API configuration: reads URL (evidence: `src/components/api-status.tsx`)
- API health indicator → PortaD API: probes health (evidence: `src/components/api-status.tsx`)
- Shared app layout → Site header: renders (evidence: `src/app/layout.tsx`)
- Shared app layout → Site footer: renders (evidence: `src/app/layout.tsx`)
- Site footer → API health indicator: renders (evidence: `src/components/site-footer.tsx`)
- Site header → Session and auth: uses (evidence: `src/components/site-header.tsx`)
