# aman-yaduvanshi-2005/note-techie architecture

> Architecture diagram of the GitHub repository aman-yaduvanshi-2005/note-techie, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aman-yaduvanshi-2005/note-techie
- Repository: https://github.com/aman-yaduvanshi-2005/note-techie

## Overview

NoteTechie is a local-first markdown note-taking app: users create or select a note, edit its title and markdown, and see changes saved to browser-backed persistent state; preview renders formatted text, code, and Mermaid diagrams. Separate Mermaid tools provide templates, a standalone diagram editor, and a gallery. The README also documents responsive dark-theme UI and syntax highlighting. Edges reflect calls visible in excerpts or capabilities explicitly stated in the README; unsampled integrations and persistence internals are not expanded.

Main entry points: [`components/NoteEditor.tsx`](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NoteEditor.tsx) (Note editor), [`app/page.tsx`](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/app/page.tsx) (Notes workspace), [`components/NotesList.tsx`](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NotesList.tsx) (Notes list), [`store/useNotesStore.ts`](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/store/useNotesStore.ts) (Notes state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_notes["Notes workflow"]
  node_home["Notes workspace<br/>[page.tsx]"]
  node_list["Notes list<br/>[NotesList.tsx]"]
  node_editor["Note editor<br/>[NoteEditor.tsx]"]
  node_state[("Notes state<br/>[useNotesStore.ts]")]
end

subgraph group_markdown["Markdown and diagrams"]
  node_markdown_preview["Markdown preview<br/>[NoteEditor.tsx]"]
  node_mermaid_renderer["Diagram renderer"]
  node_template_menu["Diagram templates"]
  node_template_data["Template catalog"]
  node_diagram_helpers["Diagram helpers<br/>[mermaidHelpers.ts]"]
  node_diagram_editor["Diagram editor<br/>[MermaidEditor.tsx]"]
  node_diagram_gallery["Diagram gallery<br/>[MermaidGallery.tsx]"]
end

subgraph group_shell["App presentation"]
  node_theme["Theme provider<br/>[theme-provider.tsx]"]
  node_button["Button control<br/>[button.tsx]"]
end

node_user(("Note taker"))

node_user -->|"uses"| node_home
node_home -->|"reads notes"| node_state
node_home -->|"loads"| node_list
node_home -->|"loads"| node_editor
node_list -->|"manages notes"| node_state
node_editor -->|"updates notes"| node_state
node_editor -->|"offers templates"| node_template_menu
node_editor -->|"renders preview"| node_markdown_preview
node_editor -->|"counts diagrams"| node_diagram_helpers
node_markdown_preview -->|"renders diagrams"| node_mermaid_renderer
node_template_menu -->|"loads templates"| node_template_data
node_diagram_editor -->|"previews diagram"| node_mermaid_renderer
node_diagram_editor -->|"loads templates"| node_template_data
node_diagram_gallery -->|"extracts diagrams"| node_diagram_helpers
node_diagram_gallery -->|"renders diagrams"| node_mermaid_renderer
node_home -->|"provides theme"| node_theme
node_editor -->|"uses controls"| node_button
node_list -->|"uses controls"| node_button

click node_home "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/app/page.tsx"
click node_list "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NotesList.tsx"
click node_editor "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NoteEditor.tsx"
click node_state "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/store/useNotesStore.ts"
click node_markdown_preview "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NoteEditor.tsx"
click node_mermaid_renderer "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/MermaidRenderer.tsx"
click node_template_menu "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/MermaidTemplateMenu.tsx"
click node_template_data "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/utils/mermaidTemplates.ts"
click node_diagram_helpers "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/utils/mermaidHelpers.ts"
click node_diagram_editor "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/mermaid/MermaidEditor.tsx"
click node_diagram_gallery "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/mermaid/MermaidGallery.tsx"
click node_theme "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/theme-provider.tsx"
click node_button "https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/ui/button.tsx"

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_list,node_editor,node_state toneBlue
class node_markdown_preview,node_mermaid_renderer,node_template_menu,node_template_data,node_diagram_helpers,node_diagram_editor,node_diagram_gallery toneAmber
class node_theme,node_button toneMint
class node_user toneIndigo
```

## Components

### Notes workflow

- [Notes workspace](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/app/page.tsx): `app/page.tsx`
- [Notes list](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NotesList.tsx): `components/NotesList.tsx`
- [Note editor](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NoteEditor.tsx): `components/NoteEditor.tsx`
- [Notes state](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/store/useNotesStore.ts): `store/useNotesStore.ts`

### Markdown and diagrams

- [Markdown preview](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/NoteEditor.tsx): `components/NoteEditor.tsx`
- [Diagram renderer](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/MermaidRenderer.tsx): `components/MermaidRenderer.tsx`
- [Diagram templates](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/MermaidTemplateMenu.tsx): `components/MermaidTemplateMenu.tsx`
- [Template catalog](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/utils/mermaidTemplates.ts): `utils/mermaidTemplates.ts`
- [Diagram helpers](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/utils/mermaidHelpers.ts): `utils/mermaidHelpers.ts`
- [Diagram editor](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/mermaid/MermaidEditor.tsx): `components/mermaid/MermaidEditor.tsx`
- [Diagram gallery](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/mermaid/MermaidGallery.tsx): `components/mermaid/MermaidGallery.tsx`

### App presentation

- [Theme provider](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/theme-provider.tsx): `components/theme-provider.tsx`
- [Button control](https://github.com/aman-yaduvanshi-2005/note-techie/blob/main/components/ui/button.tsx): `components/ui/button.tsx`

### Other components

- **Note taker**

## Connections

- Note taker → Notes workspace: uses (evidence: `README.md`)
- Notes workspace → Notes state: reads notes (evidence: `app/page.tsx`)
- Notes workspace → Notes list: loads (evidence: `app/page.tsx`)
- Notes workspace → Note editor: loads (evidence: `app/page.tsx`)
- Notes list → Notes state: manages notes (evidence: `components/NotesList.tsx`)
- Note editor → Notes state: updates notes (evidence: `components/NoteEditor.tsx`)
- Note editor → Diagram templates: offers templates (evidence: `components/NoteEditor.tsx`)
- Note editor → Markdown preview: renders preview (evidence: `components/NoteEditor.tsx`)
- Note editor → Diagram helpers: counts diagrams (evidence: `components/NoteEditor.tsx`)
- Markdown preview → Diagram renderer: renders diagrams (evidence: `components/NoteEditor.tsx`)
- Diagram templates → Template catalog: loads templates (evidence: `components/MermaidTemplateMenu.tsx`)
- Diagram editor → Diagram renderer: previews diagram (evidence: `components/mermaid/MermaidEditor.tsx`)
- Diagram editor → Template catalog: loads templates (evidence: `components/mermaid/MermaidEditor.tsx`)
- Diagram gallery → Diagram helpers: extracts diagrams (evidence: `components/mermaid/MermaidGallery.tsx`)
- Diagram gallery → Diagram renderer: renders diagrams (evidence: `components/mermaid/MermaidGallery.tsx`)
- Notes workspace → Theme provider: provides theme
- Note editor → Button control: uses controls (evidence: `components/NoteEditor.tsx`)
- Notes list → Button control: uses controls (evidence: `components/NotesList.tsx`)
