# elango-p/resumecraft architecture

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

- Interactive diagram: https://gitdiagram.com/elango-p/resumecraft
- Repository: https://github.com/elango-p/resumecraft

## Overview

ResumeCraft is a local-first resume builder: users choose a template or start in the builder, edit structured resume sections, see a live A4 preview and completeness score, then export through the browser’s print dialog. Drafts support multiple versions and debounced browser persistence under a versioned key; the README documents local-only storage and PDF export. The graph follows evidenced calls and documented behavior; section forms, template rendering, and autosave internals are grouped where their paths are known but their implementation was not sampled.

Main entry points: [`src/components/builder/builder-shell.tsx`](https://github.com/elango-p/resumecraft/blob/main/src/components/builder/builder-shell.tsx) (Builder shell), [`src/features/resume/useResumeDraft.ts`](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeDraft.ts) (Draft interface), [`src/features/resume/resume.store.ts`](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.store.ts) (Draft store), [`src/features/resume/useResumeScore.ts`](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeScore.ts) (Score hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Product entry"]
  node_home["Landing page<br/>[page.tsx]"]
  node_template_cards["Template choices"]
end

subgraph group_editing["Resume editing"]
  node_builder_page["Builder route<br/>[page.tsx]"]
  node_builder["Builder shell<br/>[builder-shell.tsx]"]
  node_section_editor["Section editor<br/>[section-editor.tsx]"]
  node_section_forms["Resume section forms"]
  node_toolbar["Builder toolbar"]
  node_score_panel["Score panel<br/>[score-panel.tsx]"]
end

subgraph group_domain["Resume domain"]
  node_draft_hook["Draft interface<br/>[useResumeDraft.ts]"]
  node_store["Draft store<br/>[resume.store.ts]"]
  node_autosave["Autosave<br/>[useAutoSave.ts]"]
  node_browser_storage[("Browser draft storage<br/>[resume.store.ts]")]
  node_resume_model["Resume model<br/>[resume.types.ts]"]
  node_validation["Draft validation<br/>[resume.schema.ts]"]
  node_resume_utils["Resume utilities<br/>[resume.utils.ts]"]
  node_demo_resume["Demo draft<br/>[demo-resume.ts]"]
  node_scoring["Resume scoring<br/>[scoring.ts]"]
  node_score_hook["Score hook<br/>[useResumeScore.ts]"]
end

subgraph group_output["Preview and export"]
  node_preview["A4 preview<br/>[resume-preview.tsx]"]
  node_document["Resume document"]
  node_templates["Resume templates"]
  node_export_hook["Print export<br/>[useResumeExport.ts]"]
  node_browser_print["Browser print dialog"]
end

node_visitor(("Resume creator"))

node_visitor -->|"opens"| node_home
node_home -->|"shows"| node_template_cards
node_visitor -->|"chooses template"| node_template_cards
node_template_cards -->|"links to"| node_builder_page
node_visitor -->|"opens"| node_builder_page
node_builder_page -->|"renders"| node_builder
node_builder -->|"loads draft"| node_draft_hook
node_builder -->|"renders"| node_section_editor
node_section_editor -.->|"selects section form"| node_section_forms
node_section_forms -.->|"updates draft"| node_draft_hook
node_builder -->|"renders"| node_toolbar
node_toolbar -->|"manages drafts"| node_draft_hook
node_builder -->|"starts autosave"| node_autosave
node_autosave -->|"saves state"| node_store
node_store -->|"reads and writes"| node_browser_storage
node_store -->|"validates stored state"| node_validation
node_store -->|"creates demo draft"| node_demo_resume
node_draft_hook -->|"selects actions"| node_store
node_draft_hook -->|"fallback draft"| node_demo_resume
node_draft_hook -->|"checks completion"| node_resume_utils
node_score_panel -->|"requests score"| node_score_hook
node_score_hook -->|"reads draft"| node_draft_hook
node_score_hook -->|"calculates score"| node_scoring
node_builder -->|"renders"| node_preview
node_preview -->|"renders document"| node_document
node_document -.->|"selects layout"| node_templates
node_builder -->|"requests export"| node_export_hook
node_export_hook -->|"opens print dialog"| node_browser_print

click node_home "https://github.com/elango-p/resumecraft/blob/main/src/app/page.tsx"
click node_template_cards "https://github.com/elango-p/resumecraft/blob/main/src/components/landing/template-preview-cards.tsx"
click node_builder_page "https://github.com/elango-p/resumecraft/blob/main/src/app/builder/page.tsx"
click node_builder "https://github.com/elango-p/resumecraft/blob/main/src/components/builder/builder-shell.tsx"
click node_section_editor "https://github.com/elango-p/resumecraft/blob/main/src/components/builder/sections/section-editor.tsx"
click node_section_forms "https://github.com/elango-p/resumecraft/tree/main/src/components/builder/sections"
click node_toolbar "https://github.com/elango-p/resumecraft/blob/main/src/components/builder/builder-toolbar.tsx"
click node_score_panel "https://github.com/elango-p/resumecraft/blob/main/src/components/builder/score-panel.tsx"
click node_draft_hook "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeDraft.ts"
click node_store "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.store.ts"
click node_autosave "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useAutoSave.ts"
click node_browser_storage "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.store.ts"
click node_resume_model "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.types.ts"
click node_validation "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.schema.ts"
click node_resume_utils "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.utils.ts"
click node_demo_resume "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/demo-resume.ts"
click node_scoring "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/scoring.ts"
click node_score_hook "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeScore.ts"
click node_preview "https://github.com/elango-p/resumecraft/blob/main/src/components/builder/resume-preview.tsx"
click node_document "https://github.com/elango-p/resumecraft/blob/main/src/components/resume/resume-document.tsx"
click node_templates "https://github.com/elango-p/resumecraft/tree/main/src/components/resume"
click node_export_hook "https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeExport.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_home,node_template_cards toneBlue
class node_builder_page,node_builder,node_section_editor,node_section_forms,node_toolbar,node_score_panel toneAmber
class node_draft_hook,node_store,node_autosave,node_browser_storage,node_resume_model,node_validation,node_resume_utils,node_demo_resume,node_scoring,node_score_hook toneMint
class node_preview,node_document,node_templates,node_export_hook,node_browser_print toneRose
class node_visitor toneIndigo
```

## Components

### Product entry

- [Landing page](https://github.com/elango-p/resumecraft/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Template choices](https://github.com/elango-p/resumecraft/blob/main/src/components/landing/template-preview-cards.tsx): `src/components/landing/template-preview-cards.tsx`

### Resume editing

- [Builder route](https://github.com/elango-p/resumecraft/blob/main/src/app/builder/page.tsx): `src/app/builder/page.tsx`
- [Builder shell](https://github.com/elango-p/resumecraft/blob/main/src/components/builder/builder-shell.tsx): `src/components/builder/builder-shell.tsx`
- [Section editor](https://github.com/elango-p/resumecraft/blob/main/src/components/builder/sections/section-editor.tsx): `src/components/builder/sections/section-editor.tsx`
- [Resume section forms](https://github.com/elango-p/resumecraft/tree/main/src/components/builder/sections): `src/components/builder/sections`
- [Builder toolbar](https://github.com/elango-p/resumecraft/blob/main/src/components/builder/builder-toolbar.tsx): `src/components/builder/builder-toolbar.tsx`
- [Score panel](https://github.com/elango-p/resumecraft/blob/main/src/components/builder/score-panel.tsx): `src/components/builder/score-panel.tsx`

### Resume domain

- [Draft interface](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeDraft.ts): `src/features/resume/useResumeDraft.ts`
- [Draft store](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.store.ts): `src/features/resume/resume.store.ts`
- [Autosave](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useAutoSave.ts): `src/features/resume/useAutoSave.ts`
- [Browser draft storage](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.store.ts): `src/features/resume/resume.store.ts`
- [Resume model](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.types.ts): `src/features/resume/resume.types.ts`
- [Draft validation](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.schema.ts): `src/features/resume/resume.schema.ts`
- [Resume utilities](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/resume.utils.ts): `src/features/resume/resume.utils.ts`
- [Demo draft](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/demo-resume.ts): `src/features/resume/demo-resume.ts`
- [Resume scoring](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/scoring.ts): `src/features/resume/scoring.ts`
- [Score hook](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeScore.ts): `src/features/resume/useResumeScore.ts`

### Preview and export

- [A4 preview](https://github.com/elango-p/resumecraft/blob/main/src/components/builder/resume-preview.tsx): `src/components/builder/resume-preview.tsx`
- [Resume document](https://github.com/elango-p/resumecraft/blob/main/src/components/resume/resume-document.tsx): `src/components/resume/resume-document.tsx`
- [Resume templates](https://github.com/elango-p/resumecraft/tree/main/src/components/resume): `src/components/resume`
- [Print export](https://github.com/elango-p/resumecraft/blob/main/src/features/resume/useResumeExport.ts): `src/features/resume/useResumeExport.ts`
- **Browser print dialog**

### Other components

- **Resume creator**

## Connections

- Resume creator → Landing page: opens (evidence: `src/app/page.tsx`)
- Landing page → Template choices: shows (evidence: `src/app/page.tsx`)
- Resume creator → Template choices: chooses template (evidence: `src/components/landing/template-preview-cards.tsx`)
- Template choices → Builder route: links to (evidence: `src/components/landing/template-preview-cards.tsx`)
- Resume creator → Builder route: opens
- Builder route → Builder shell: renders (evidence: `src/app/builder/page.tsx`)
- Builder shell → Draft interface: loads draft (evidence: `src/components/builder/builder-shell.tsx`)
- Builder shell → Section editor: renders (evidence: `src/components/builder/builder-shell.tsx`)
- Section editor → Resume section forms: selects section form
- Resume section forms → Draft interface: updates draft (evidence: `src/components/builder/sections/custom-form.tsx`)
- Builder shell → Builder toolbar: renders (evidence: `src/components/builder/builder-shell.tsx`)
- Builder toolbar → Draft interface: manages drafts (evidence: `src/components/builder/builder-toolbar.tsx`)
- Builder shell → Autosave: starts autosave (evidence: `src/components/builder/builder-shell.tsx`)
- Autosave → Draft store: saves state (evidence: `src/features/resume/useAutoSave.ts`)
- Draft store → Browser draft storage: reads and writes (evidence: `src/features/resume/resume.store.ts`)
- Draft store → Draft validation: validates stored state (evidence: `src/features/resume/resume.store.ts`)
- Draft store → Demo draft: creates demo draft (evidence: `src/features/resume/resume.store.ts`)
- Draft interface → Draft store: selects actions (evidence: `src/features/resume/useResumeDraft.ts`)
- Draft interface → Demo draft: fallback draft (evidence: `src/features/resume/useResumeDraft.ts`)
- Draft interface → Resume utilities: checks completion (evidence: `src/features/resume/useResumeDraft.ts`)
- Score panel → Score hook: requests score (evidence: `src/components/builder/score-panel.tsx`)
- Score hook → Draft interface: reads draft (evidence: `src/features/resume/useResumeScore.ts`)
- Score hook → Resume scoring: calculates score (evidence: `src/features/resume/useResumeScore.ts`)
- Builder shell → A4 preview: renders (evidence: `src/components/builder/builder-shell.tsx`)
- A4 preview → Resume document: renders document (evidence: `src/components/builder/resume-preview.tsx`)
- Resume document → Resume templates: selects layout
- Builder shell → Print export: requests export (evidence: `src/components/builder/builder-shell.tsx`)
- Print export → Browser print dialog: opens print dialog (evidence: `README.md`)
