# nithinxd/studio architecture

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

- Interactive diagram: https://gitdiagram.com/nithinxd/studio
- Repository: https://github.com/nithinxd/studio

## Overview

This repository is a web app for submitting PDF documents for approval, tracking their status, and administering reviews. The main workflow is login, upload a PDF and record its metadata, then review it and update its decision; users can view and delete submissions and download watermarked decisions. Firebase Auth and Firestore and Supabase Storage are distinct backends. The README identifies the app only as a Next.js starter, so product capabilities here are inferred from sampled routes and imports; unsampled behavior is not assumed.

Main entry points: [`src/lib/firebaseService.js`](https://github.com/nithinxd/studio/blob/master/src/lib/firebaseService.js) (Document records), [`src/app/status/page.tsx`](https://github.com/nithinxd/studio/blob/master/src/app/status/page.tsx) (Status tracking), [`src/app/upload/page.tsx`](https://github.com/nithinxd/studio/blob/master/src/app/upload/page.tsx) (PDF submission), [`src/app/admin/page.tsx`](https://github.com/nithinxd/studio/blob/master/src/app/admin/page.tsx) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_login["Login<br/>[page.tsx]"]
  node_auth["Auth context<br/>[use-auth.tsx]"]
end

subgraph group_submission["Submission"]
  node_upload["PDF submission<br/>[page.tsx]"]
  node_status["Status tracking<br/>[page.tsx]"]
end

subgraph group_review["Review"]
  node_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_reviewpage["Review route<br/>[page.tsx]"]
  node_review["Document review"]
  node_watermark["PDF watermarking<br/>[pdfWatermark.ts]"]
end

subgraph group_services["Data and files"]
  node_storage["PDF storage"]
  node_metadata["Document records<br/>[firebaseService.js]"]
  node_firestore[("Firestore")]
  node_supabase[("Supabase Storage")]
  node_firebaseauth["Firebase Auth"]
end

node_user(("User"))
node_admin(("Administrator"))

node_user -->|"signs in"| node_login
node_login -->|"authenticates"| node_firebaseauth
node_auth -->|"tracks session"| node_firebaseauth
node_user -->|"submits PDF"| node_upload
node_upload -->|"uploads PDF"| node_storage
node_storage -->|"stores file"| node_supabase
node_upload -->|"records submission"| node_metadata
node_metadata -->|"writes and reads"| node_firestore
node_user -->|"views status"| node_status
node_status -->|"loads and deletes"| node_metadata
node_status -->|"deletes PDF"| node_storage
node_status -->|"downloads marked PDF"| node_watermark
node_admin -->|"manages submissions"| node_dashboard
node_dashboard -->|"loads submissions"| node_metadata
node_dashboard -->|"downloads marked PDF"| node_watermark
node_reviewpage -->|"renders review"| node_review
node_review -->|"updates decision"| node_metadata
node_review -->|"marks decision PDF"| node_watermark

click node_login "https://github.com/nithinxd/studio/blob/master/src/app/login/page.tsx"
click node_auth "https://github.com/nithinxd/studio/blob/master/src/hooks/use-auth.tsx"
click node_upload "https://github.com/nithinxd/studio/blob/master/src/app/upload/page.tsx"
click node_storage "https://github.com/nithinxd/studio/blob/master/src/lib/supabasePdfUpload.js"
click node_metadata "https://github.com/nithinxd/studio/blob/master/src/lib/firebaseService.js"
click node_status "https://github.com/nithinxd/studio/blob/master/src/app/status/page.tsx"
click node_dashboard "https://github.com/nithinxd/studio/blob/master/src/app/admin/page.tsx"
click node_reviewpage "https://github.com/nithinxd/studio/blob/master/src/app/admin/review/%5Bid%5D/page.tsx"
click node_review "https://github.com/nithinxd/studio/blob/master/src/app/admin/review/%5Bid%5D/DocumentReviewClient.tsx"
click node_watermark "https://github.com/nithinxd/studio/blob/master/src/lib/pdfWatermark.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_login,node_auth,node_user toneBlue
class node_upload,node_status toneAmber
class node_dashboard,node_reviewpage,node_review,node_watermark toneMint
class node_storage,node_metadata,node_firestore,node_supabase,node_firebaseauth toneRose
class node_admin toneIndigo
```

## Components

### Identity

- [Login](https://github.com/nithinxd/studio/blob/master/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Auth context](https://github.com/nithinxd/studio/blob/master/src/hooks/use-auth.tsx): `src/hooks/use-auth.tsx`

### Submission

- [PDF submission](https://github.com/nithinxd/studio/blob/master/src/app/upload/page.tsx): `src/app/upload/page.tsx`
- [Status tracking](https://github.com/nithinxd/studio/blob/master/src/app/status/page.tsx): `src/app/status/page.tsx`

### Review

- [Admin dashboard](https://github.com/nithinxd/studio/blob/master/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Review route](https://github.com/nithinxd/studio/blob/master/src/app/admin/review/%5Bid%5D/page.tsx): `src/app/admin/review/[id]/page.tsx`
- [Document review](https://github.com/nithinxd/studio/blob/master/src/app/admin/review/%5Bid%5D/DocumentReviewClient.tsx): `src/app/admin/review/[id]/DocumentReviewClient.tsx`
- [PDF watermarking](https://github.com/nithinxd/studio/blob/master/src/lib/pdfWatermark.ts): `src/lib/pdfWatermark.ts`

### Data and files

- [PDF storage](https://github.com/nithinxd/studio/blob/master/src/lib/supabasePdfUpload.js): `src/lib/supabasePdfUpload.js`
- [Document records](https://github.com/nithinxd/studio/blob/master/src/lib/firebaseService.js): `src/lib/firebaseService.js`
- **Firestore**
- **Supabase Storage**
- **Firebase Auth**

### Other components

- **User**
- **Administrator**

## Connections

- User → Login: signs in (evidence: `src/app/login/page.tsx`)
- Login → Firebase Auth: authenticates (evidence: `src/app/login/page.tsx`)
- Auth context → Firebase Auth: tracks session (evidence: `src/hooks/use-auth.tsx`)
- User → PDF submission: submits PDF (evidence: `src/app/upload/page.tsx`)
- PDF submission → PDF storage: uploads PDF (evidence: `src/app/upload/page.tsx`)
- PDF storage → Supabase Storage: stores file (evidence: `src/lib/supabasePdfUpload.js`)
- PDF submission → Document records: records submission (evidence: `src/app/upload/page.tsx`)
- Document records → Firestore: writes and reads (evidence: `src/lib/firebaseService.js`)
- User → Status tracking: views status (evidence: `src/app/status/page.tsx`)
- Status tracking → Document records: loads and deletes (evidence: `src/app/status/page.tsx`)
- Status tracking → PDF storage: deletes PDF (evidence: `src/app/status/page.tsx`)
- Status tracking → PDF watermarking: downloads marked PDF (evidence: `src/app/status/page.tsx`)
- Administrator → Admin dashboard: manages submissions (evidence: `src/app/admin/page.tsx`)
- Admin dashboard → Document records: loads submissions (evidence: `src/app/admin/page.tsx`)
- Admin dashboard → PDF watermarking: downloads marked PDF (evidence: `src/app/admin/page.tsx`)
- Review route → Document review: renders review (evidence: `src/app/admin/review/[id]/page.tsx`)
- Document review → Document records: updates decision (evidence: `src/app/admin/review/[id]/DocumentReviewClient.tsx`)
- Document review → PDF watermarking: marks decision PDF (evidence: `src/app/admin/review/[id]/DocumentReviewClient.tsx`)
