# mahimjain93/namka architecture

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

## Overview

Na(m)ka is a personalized architecture-digest web app. The main workflow lets a reader request an issue, generates and stores its sections and a vocabulary flashcard, then displays the result. Readers can also browse saved issues and study cards. Generation and storage behavior is visible in the sampled API route; archive and flashcard interactions are visible in their page components. The README provides no further capability details, and no profile page appears in the tree, so that navigation link is not modeled.

Main entry points: [`namka/lib/supabase.js`](https://github.com/mahimjain93/namka/blob/main/namka/lib/supabase.js) (Supabase client), [`namka/app/api/generate/route.js`](https://github.com/mahimjain93/namka/blob/main/namka/app/api/generate/route.js) (Issue generator), [`namka/app/page.js`](https://github.com/mahimjain93/namka/blob/main/namka/app/page.js) (Today issue), [`namka/app/archive/page.js`](https://github.com/mahimjain93/namka/blob/main/namka/app/archive/page.js) (Issue archive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reader["Reader experience"]
  node_today["Today issue<br/>[page.js]"]
  node_archive["Issue archive<br/>[page.js]"]
  node_detail["Issue detail<br/>[page.js]"]
  node_study["Flashcard study<br/>[page.js]"]
  node_nav["Navigation<br/>[Navbar.js]"]
  node_layout["Application shell<br/>[layout.js]"]
end

subgraph group_generation["Issue generation"]
  node_generate["Issue generator<br/>[route.js]"]
end

subgraph group_data["Persistence"]
  node_supabase["Supabase client<br/>[supabase.js]"]
end

node_reader(("Reader"))
node_gemini{{"Gemini API"}}
node_db[("Supabase database")]

node_reader -->|"requests issue"| node_today
node_today -->|"POSTs to"| node_generate
node_generate -->|"reads persona, sources, history"| node_supabase
node_generate -->|"generates content"| node_gemini
node_generate -->|"stores issue and card"| node_supabase
node_today -->|"renders response"| node_supabase
node_reader -->|"browses issues"| node_archive
node_archive -->|"reads issue summaries"| node_supabase
node_reader -->|"opens issue"| node_detail
node_detail -->|"reads issue"| node_supabase
node_reader -->|"studies terms"| node_study
node_study -->|"reads and updates cards"| node_supabase
node_supabase -.->|"queries and writes"| node_db
node_layout -->|"renders"| node_nav
node_nav -.->|"offers page links"| node_reader

click node_today "https://github.com/mahimjain93/namka/blob/main/namka/app/page.js"
click node_archive "https://github.com/mahimjain93/namka/blob/main/namka/app/archive/page.js"
click node_detail "https://github.com/mahimjain93/namka/blob/main/namka/app/archive/%5Bid%5D/page.js"
click node_study "https://github.com/mahimjain93/namka/blob/main/namka/app/flashcards/page.js"
click node_nav "https://github.com/mahimjain93/namka/blob/main/namka/app/components/Navbar.js"
click node_generate "https://github.com/mahimjain93/namka/blob/main/namka/app/api/generate/route.js"
click node_supabase "https://github.com/mahimjain93/namka/blob/main/namka/lib/supabase.js"
click node_layout "https://github.com/mahimjain93/namka/blob/main/namka/app/layout.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_today,node_archive,node_detail,node_study,node_nav,node_layout toneBlue
class node_generate,node_db toneAmber
class node_supabase,node_gemini toneMint
class node_reader toneIndigo
```

## Components

### Reader experience

- [Today issue](https://github.com/mahimjain93/namka/blob/main/namka/app/page.js): `namka/app/page.js`
- [Issue archive](https://github.com/mahimjain93/namka/blob/main/namka/app/archive/page.js): `namka/app/archive/page.js`
- [Issue detail](https://github.com/mahimjain93/namka/blob/main/namka/app/archive/%5Bid%5D/page.js): `namka/app/archive/[id]/page.js`
- [Flashcard study](https://github.com/mahimjain93/namka/blob/main/namka/app/flashcards/page.js): `namka/app/flashcards/page.js`
- [Navigation](https://github.com/mahimjain93/namka/blob/main/namka/app/components/Navbar.js): `namka/app/components/Navbar.js`
- [Application shell](https://github.com/mahimjain93/namka/blob/main/namka/app/layout.js): `namka/app/layout.js`

### Issue generation

- [Issue generator](https://github.com/mahimjain93/namka/blob/main/namka/app/api/generate/route.js): `namka/app/api/generate/route.js`

### Persistence

- [Supabase client](https://github.com/mahimjain93/namka/blob/main/namka/lib/supabase.js): `namka/lib/supabase.js`

### Other components

- **Reader**
- **Gemini API**
- **Supabase database**

## Connections

- Reader → Today issue: requests issue (evidence: `namka/app/page.js`)
- Today issue → Issue generator: POSTs to (evidence: `namka/app/page.js`)
- Issue generator → Supabase client: reads persona, sources, history (evidence: `namka/app/api/generate/route.js`)
- Issue generator → Gemini API: generates content (evidence: `namka/app/api/generate/route.js`)
- Issue generator → Supabase client: stores issue and card (evidence: `namka/app/api/generate/route.js`)
- Today issue → Supabase client: renders response (evidence: `namka/app/page.js`)
- Reader → Issue archive: browses issues (evidence: `namka/app/archive/page.js`)
- Issue archive → Supabase client: reads issue summaries (evidence: `namka/app/archive/page.js`)
- Reader → Issue detail: opens issue (evidence: `namka/app/archive/[id]/page.js`)
- Issue detail → Supabase client: reads issue (evidence: `namka/app/archive/[id]/page.js`)
- Reader → Flashcard study: studies terms (evidence: `namka/app/flashcards/page.js`)
- Flashcard study → Supabase client: reads and updates cards (evidence: `namka/app/flashcards/page.js`)
- Supabase client → Supabase database: queries and writes
- Application shell → Navigation: renders (evidence: `namka/app/layout.js`)
- Navigation → Reader: offers page links (evidence: `namka/app/components/Navbar.js`)
