# vishnu17306/hackathon_idea_vault architecture

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

- Interactive diagram: https://gitdiagram.com/vishnu17306/hackathon_idea_vault
- Repository: https://github.com/vishnu17306/hackathon_idea_vault

## Overview

Hackathon Idea Vault is a React app for tracking project ideas and learning-roadmap steps. Users add and manage ideas on a status board, create and complete roadmap steps, and view progress and milestone badges on the dashboard. App owns shared state and CRUD actions, while the API module communicates with a local JSON Server backed by db.json. The README identifies only a React/Vite template, so product capabilities here are based on the sampled source; About-page behavior was not sampled.

Main entry points: [`src/App.jsx`](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/App.jsx) (App state and routes), [`src/pages/Ideas.jsx`](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Ideas.jsx) (Ideas page), [`src/components/StatusLine.jsx`](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/StatusLine.jsx) (Status column), [`src/main.jsx`](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/main.jsx) (React entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_entry["React entry<br/>[main.jsx]"]
  node_app["App state and routes<br/>[App.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_boundary["Error boundary<br/>[ErrorBoundary.jsx]"]
  node_dashboard["Progress dashboard<br/>[Dashboard.jsx]"]
  node_about["About page<br/>[About.jsx]"]
end

subgraph group_ideas["Idea tracking"]
  node_ideas["Ideas page<br/>[Ideas.jsx]"]
  node_form["Idea form<br/>[IdeaForm.jsx]"]
  node_board["Status board<br/>[Board.jsx]"]
  node_status["Status column<br/>[StatusLine.jsx]"]
  node_card["Idea card<br/>[IdeaCard.jsx]"]
end

subgraph group_roadmap["Learning roadmap"]
  node_roadmap["Roadmap page<br/>[Roadmap.jsx]"]
end

subgraph group_storage["Persistence"]
  node_api["CRUD API client<br/>[api.js]"]
  node_jsonserver["Local JSON Server"]
  node_database[("JSON data store<br/>[db.json]")]
end

node_user(("User"))

node_user -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"wraps routes"| node_boundary
node_app -->|"routes and passes data"| node_dashboard
node_app -->|"routes and passes actions"| node_ideas
node_app -->|"routes and passes actions"| node_roadmap
node_app -->|"routes to"| node_about
node_app -->|"loads and mutates"| node_api
node_ideas -->|"renders"| node_form
node_ideas -->|"renders"| node_board
node_board -->|"renders"| node_status
node_status -->|"renders"| node_card
node_form -->|"calls add callback"| node_app
node_status -->|"calls move callback"| node_app
node_card -->|"calls move or delete"| node_app
node_roadmap -->|"calls step callbacks"| node_app
node_api -->|"sends HTTP CRUD"| node_jsonserver
node_jsonserver -->|"serves db.json"| node_database

click node_entry "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/main.jsx"
click node_app "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/App.jsx"
click node_navbar "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/Navbar.jsx"
click node_boundary "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/ErrorBoundary.jsx"
click node_dashboard "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Dashboard.jsx"
click node_about "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/About.jsx"
click node_ideas "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Ideas.jsx"
click node_form "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/IdeaForm.jsx"
click node_board "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/Board.jsx"
click node_status "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/StatusLine.jsx"
click node_card "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/IdeaCard.jsx"
click node_roadmap "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Roadmap.jsx"
click node_api "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/api.js"
click node_database "https://github.com/vishnu17306/hackathon_idea_vault/blob/main/db.json"

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_entry,node_app,node_navbar,node_boundary,node_dashboard,node_about,node_user toneBlue
class node_ideas,node_form,node_board,node_status,node_card toneAmber
class node_roadmap toneMint
class node_api,node_jsonserver,node_database toneRose
```

## Components

### App runtime

- [React entry](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/main.jsx): `src/main.jsx`
- [App state and routes](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/App.jsx): `src/App.jsx`
- [Navigation](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Error boundary](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/ErrorBoundary.jsx): `src/pages/ErrorBoundary.jsx`
- [Progress dashboard](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [About page](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/About.jsx): `src/pages/About.jsx`

### Idea tracking

- [Ideas page](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Ideas.jsx): `src/pages/Ideas.jsx`
- [Idea form](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/IdeaForm.jsx): `src/components/IdeaForm.jsx`
- [Status board](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/Board.jsx): `src/components/Board.jsx`
- [Status column](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/StatusLine.jsx): `src/components/StatusLine.jsx`
- [Idea card](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/components/IdeaCard.jsx): `src/components/IdeaCard.jsx`

### Learning roadmap

- [Roadmap page](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/pages/Roadmap.jsx): `src/pages/Roadmap.jsx`

### Persistence

- [CRUD API client](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/src/api.js): `src/api.js`
- **Local JSON Server**
- [JSON data store](https://github.com/vishnu17306/hackathon_idea_vault/blob/main/db.json): `db.json`

### Other components

- **User**

## Connections

- User → React entry: opens app (evidence: `src/main.jsx`)
- React entry → App state and routes: renders (evidence: `src/main.jsx`)
- App state and routes → Navigation: renders (evidence: `src/App.jsx`)
- App state and routes → Error boundary: wraps routes (evidence: `src/App.jsx`)
- App state and routes → Progress dashboard: routes and passes data (evidence: `src/App.jsx`)
- App state and routes → Ideas page: routes and passes actions (evidence: `src/App.jsx`)
- App state and routes → Roadmap page: routes and passes actions (evidence: `src/App.jsx`)
- App state and routes → About page: routes to (evidence: `src/App.jsx`)
- App state and routes → CRUD API client: loads and mutates (evidence: `src/App.jsx`)
- Ideas page → Idea form: renders (evidence: `src/pages/Ideas.jsx`)
- Ideas page → Status board: renders (evidence: `src/pages/Ideas.jsx`)
- Status board → Status column: renders (evidence: `src/components/Board.jsx`)
- Status column → Idea card: renders (evidence: `src/components/StatusLine.jsx`)
- Idea form → App state and routes: calls add callback (evidence: `src/components/IdeaForm.jsx`)
- Status column → App state and routes: calls move callback (evidence: `src/components/StatusLine.jsx`)
- Idea card → App state and routes: calls move or delete (evidence: `src/components/IdeaCard.jsx`)
- Roadmap page → App state and routes: calls step callbacks (evidence: `src/pages/Roadmap.jsx`)
- CRUD API client → Local JSON Server: sends HTTP CRUD (evidence: `src/api.js`)
- Local JSON Server → JSON data store: serves db.json
