# leeexp3rt/cv-maker architecture

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

- Interactive diagram: https://gitdiagram.com/leeexp3rt/cv-maker
- Repository: https://github.com/leeexp3rt/cv-maker

## Overview

CV-Maker is a browser-based résumé authoring app for students. Users edit structured résumé sections, manage multiple projects, and see a paginated preview that can be printed to PDF; project data stays in browser localStorage. The graph separates app entry, editing and project state, résumé rendering, and shared presentation/data utilities. README documents additional capabilities (themes, bilingual headings, icon upload, Markdown, JSON validation/import, and anonymization); sampled excerpts confirm several, while unsampled implementation details and their internal links are not asserted.

Main entry points: [`src/EditorApp.tsx`](https://github.com/leeexp3rt/cv-maker/blob/main/src/EditorApp.tsx) (Editor workspace), [`src/PaginatedResume.tsx`](https://github.com/leeexp3rt/cv-maker/blob/main/src/PaginatedResume.tsx) (Paginated preview), [`src/main.tsx`](https://github.com/leeexp3rt/cv-maker/blob/main/src/main.tsx) (Route entry), [`src/components`](https://github.com/leeexp3rt/cv-maker/tree/main/src/components) (Resume sections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App surfaces"]
  node_router["Route entry<br/>[main.tsx]"]
  node_home["Home and demo<br/>[HomePage.tsx]"]
  node_layout["Page layout<br/>[Layout.tsx]"]
  node_docs["Documentation page<br/>[DocsPage.tsx]"]
end

subgraph group_editing["Editing and projects"]
  node_editor["Editor workspace<br/>[EditorApp.tsx]"]
  node_project_sidebar["Project sidebar<br/>[ProjectSidebar.tsx]"]
  node_project_manager["Project manager"]
  node_storage_hook["Local storage hook<br/>[useLocalStorage.ts]"]
  node_section_editors["Section editors"]
  node_drag_list["Drag sorting<br/>[DraggableList.tsx]"]
  node_json_tools["JSON import/export<br/>[envelope.ts]"]
  node_anon_controls["Anonymity controls<br/>[AnonSwitcher.tsx]"]
end

subgraph group_rendering["Resume rendering"]
  node_preview["Paginated preview"]
  node_resume_view["Resume view<br/>[Resume.tsx]"]
  node_resume_sections["Resume sections"]
  node_markdown["Markdown text<br/>[MarkdownText.tsx]"]
end

subgraph group_shared["Shared data and presentation"]
  node_validation["Import validation<br/>[validate.ts]"]
  node_anonymizer["Anonymization<br/>[anonymize.ts]"]
  node_theme["Themes and typography<br/>[theme.ts]"]
  node_icons["Icon system<br/>[Icons.tsx]"]
  node_resume_types["Resume data model<br/>[resume.ts]"]
end

node_visitor(("Résumé author"))
node_browser_storage[("Browser localStorage")]
node_pdf(("Print to PDF"))

node_visitor -->|"opens app"| node_router
node_router -->|"routes editor"| node_editor
node_router -->|"routes home"| node_home
node_router -->|"routes docs"| node_docs
node_editor -->|"manages projects"| node_project_manager
node_editor -->|"configures actions"| node_project_sidebar
node_project_manager -->|"persists state"| node_storage_hook
node_storage_hook -->|"reads and writes"| node_browser_storage
node_editor -->|"edits sections"| node_section_editors
node_section_editors -->|"uses sorting"| node_drag_list
node_editor -->|"imports exports"| node_json_tools
node_editor -->|"validates imports"| node_validation
node_editor -->|"configures privacy"| node_anon_controls
node_preview -->|"masks data"| node_anonymizer
node_editor -->|"shows preview"| node_preview
node_home -->|"shows examples"| node_resume_view
node_preview -->|"renders sections"| node_resume_sections
node_resume_view -->|"renders sections"| node_resume_sections
node_resume_sections -->|"renders descriptions"| node_markdown
node_resume_sections -->|"renders icons"| node_icons
node_editor -.->|"selects settings"| node_theme
node_preview -->|"applies styles"| node_theme
node_section_editors -->|"chooses icons"| node_icons
node_editor -->|"prints resume"| node_pdf
node_home -->|"uses layout"| node_layout
node_editor -->|"uses layout"| node_layout
node_docs -->|"uses layout"| node_layout
node_editor -->|"edits typed data"| node_resume_types
node_preview -->|"renders typed data"| node_resume_types

click node_router "https://github.com/leeexp3rt/cv-maker/blob/main/src/main.tsx"
click node_editor "https://github.com/leeexp3rt/cv-maker/blob/main/src/EditorApp.tsx"
click node_project_sidebar "https://github.com/leeexp3rt/cv-maker/blob/main/src/components/editor/ProjectSidebar.tsx"
click node_project_manager "https://github.com/leeexp3rt/cv-maker/blob/main/src/hooks/useProjectManager.ts"
click node_storage_hook "https://github.com/leeexp3rt/cv-maker/blob/main/src/hooks/useLocalStorage.ts"
click node_section_editors "https://github.com/leeexp3rt/cv-maker/tree/main/src/components/editor"
click node_drag_list "https://github.com/leeexp3rt/cv-maker/blob/main/src/components/editor/DraggableList.tsx"
click node_json_tools "https://github.com/leeexp3rt/cv-maker/blob/main/src/utils/envelope.ts"
click node_validation "https://github.com/leeexp3rt/cv-maker/blob/main/src/utils/validate.ts"
click node_anon_controls "https://github.com/leeexp3rt/cv-maker/blob/main/src/components/editor/AnonSwitcher.tsx"
click node_anonymizer "https://github.com/leeexp3rt/cv-maker/blob/main/src/utils/anonymize.ts"
click node_preview "https://github.com/leeexp3rt/cv-maker/blob/main/src/PaginatedResume.tsx"
click node_resume_view "https://github.com/leeexp3rt/cv-maker/blob/main/src/Resume.tsx"
click node_resume_sections "https://github.com/leeexp3rt/cv-maker/tree/main/src/components"
click node_markdown "https://github.com/leeexp3rt/cv-maker/blob/main/src/components/MarkdownText.tsx"
click node_theme "https://github.com/leeexp3rt/cv-maker/blob/main/src/styles/theme.ts"
click node_icons "https://github.com/leeexp3rt/cv-maker/blob/main/src/components/Icons.tsx"
click node_home "https://github.com/leeexp3rt/cv-maker/blob/main/src/HomePage.tsx"
click node_layout "https://github.com/leeexp3rt/cv-maker/blob/main/src/components/Layout.tsx"
click node_docs "https://github.com/leeexp3rt/cv-maker/blob/main/src/DocsPage.tsx"
click node_resume_types "https://github.com/leeexp3rt/cv-maker/blob/main/src/types/resume.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_router,node_home,node_layout,node_docs toneBlue
class node_editor,node_project_sidebar,node_project_manager,node_storage_hook,node_section_editors,node_drag_list,node_json_tools,node_anon_controls,node_browser_storage toneAmber
class node_preview,node_resume_view,node_resume_sections,node_markdown toneMint
class node_validation,node_anonymizer,node_theme,node_icons,node_resume_types toneRose
class node_visitor,node_pdf toneIndigo
```

## Components

### App surfaces

- [Route entry](https://github.com/leeexp3rt/cv-maker/blob/main/src/main.tsx): `src/main.tsx`
- [Home and demo](https://github.com/leeexp3rt/cv-maker/blob/main/src/HomePage.tsx): `src/HomePage.tsx`
- [Page layout](https://github.com/leeexp3rt/cv-maker/blob/main/src/components/Layout.tsx): `src/components/Layout.tsx`
- [Documentation page](https://github.com/leeexp3rt/cv-maker/blob/main/src/DocsPage.tsx): `src/DocsPage.tsx`

### Editing and projects

- [Editor workspace](https://github.com/leeexp3rt/cv-maker/blob/main/src/EditorApp.tsx): `src/EditorApp.tsx`
- [Project sidebar](https://github.com/leeexp3rt/cv-maker/blob/main/src/components/editor/ProjectSidebar.tsx): `src/components/editor/ProjectSidebar.tsx`
- [Project manager](https://github.com/leeexp3rt/cv-maker/blob/main/src/hooks/useProjectManager.ts): `src/hooks/useProjectManager.ts`
- [Local storage hook](https://github.com/leeexp3rt/cv-maker/blob/main/src/hooks/useLocalStorage.ts): `src/hooks/useLocalStorage.ts`
- [Section editors](https://github.com/leeexp3rt/cv-maker/tree/main/src/components/editor): `src/components/editor`
- [Drag sorting](https://github.com/leeexp3rt/cv-maker/blob/main/src/components/editor/DraggableList.tsx): `src/components/editor/DraggableList.tsx`
- [JSON import/export](https://github.com/leeexp3rt/cv-maker/blob/main/src/utils/envelope.ts): `src/utils/envelope.ts`
- [Anonymity controls](https://github.com/leeexp3rt/cv-maker/blob/main/src/components/editor/AnonSwitcher.tsx): `src/components/editor/AnonSwitcher.tsx`

### Resume rendering

- [Paginated preview](https://github.com/leeexp3rt/cv-maker/blob/main/src/PaginatedResume.tsx): `src/PaginatedResume.tsx`
- [Resume view](https://github.com/leeexp3rt/cv-maker/blob/main/src/Resume.tsx): `src/Resume.tsx`
- [Resume sections](https://github.com/leeexp3rt/cv-maker/tree/main/src/components): `src/components`
- [Markdown text](https://github.com/leeexp3rt/cv-maker/blob/main/src/components/MarkdownText.tsx): `src/components/MarkdownText.tsx`

### Shared data and presentation

- [Import validation](https://github.com/leeexp3rt/cv-maker/blob/main/src/utils/validate.ts): `src/utils/validate.ts`
- [Anonymization](https://github.com/leeexp3rt/cv-maker/blob/main/src/utils/anonymize.ts): `src/utils/anonymize.ts`
- [Themes and typography](https://github.com/leeexp3rt/cv-maker/blob/main/src/styles/theme.ts): `src/styles/theme.ts`
- [Icon system](https://github.com/leeexp3rt/cv-maker/blob/main/src/components/Icons.tsx): `src/components/Icons.tsx`
- [Resume data model](https://github.com/leeexp3rt/cv-maker/blob/main/src/types/resume.ts): `src/types/resume.ts`

### Other components

- **Résumé author**
- **Browser localStorage**
- **Print to PDF**

## Connections

- Résumé author → Route entry: opens app (evidence: `src/main.tsx`)
- Route entry → Editor workspace: routes editor (evidence: `src/main.tsx`)
- Route entry → Home and demo: routes home (evidence: `src/main.tsx`)
- Route entry → Documentation page: routes docs (evidence: `src/main.tsx`)
- Editor workspace → Project manager: manages projects (evidence: `src/EditorApp.tsx`)
- Editor workspace → Project sidebar: configures actions (evidence: `src/EditorApp.tsx`)
- Project manager → Local storage hook: persists state (evidence: `src/hooks/useProjectManager.ts`)
- Local storage hook → Browser localStorage: reads and writes (evidence: `src/hooks/useLocalStorage.ts`)
- Editor workspace → Section editors: edits sections (evidence: `src/EditorApp.tsx`)
- Section editors → Drag sorting: uses sorting (evidence: `src/components/editor/EducationEditor.tsx`)
- Editor workspace → JSON import/export: imports exports (evidence: `src/EditorApp.tsx`)
- Editor workspace → Import validation: validates imports (evidence: `src/EditorApp.tsx`)
- Editor workspace → Anonymity controls: configures privacy (evidence: `src/EditorApp.tsx`)
- Paginated preview → Anonymization: masks data (evidence: `src/PaginatedResume.tsx`)
- Editor workspace → Paginated preview: shows preview (evidence: `src/EditorApp.tsx`)
- Home and demo → Resume view: shows examples (evidence: `src/HomePage.tsx`)
- Paginated preview → Resume sections: renders sections (evidence: `src/PaginatedResume.tsx`)
- Resume view → Resume sections: renders sections (evidence: `src/Resume.tsx`)
- Resume sections → Markdown text: renders descriptions (evidence: `src/components/Internship.tsx`)
- Resume sections → Icon system: renders icons (evidence: `src/components/Education.tsx`)
- Editor workspace → Themes and typography: selects settings
- Paginated preview → Themes and typography: applies styles (evidence: `src/PaginatedResume.tsx`)
- Section editors → Icon system: chooses icons (evidence: `src/components/editor/IconPicker.tsx`)
- Editor workspace → Print to PDF: prints resume (evidence: `README.md`)
- Home and demo → Page layout: uses layout (evidence: `src/HomePage.tsx`)
- Editor workspace → Page layout: uses layout (evidence: `src/EditorApp.tsx`)
- Documentation page → Page layout: uses layout (evidence: `src/DocsPage.tsx`)
- Editor workspace → Resume data model: edits typed data (evidence: `src/EditorApp.tsx`)
- Paginated preview → Resume data model: renders typed data (evidence: `src/PaginatedResume.tsx`)
