# hm186812/webbrief architecture

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

- Interactive diagram: https://gitdiagram.com/hm186812/webbrief
- Repository: https://github.com/hm186812/webbrief

## Overview

WebBrief Lao is a client-intake app for capturing website requirements and sharing a brief with an agency. The active entry point renders a compact intake form and persists the brief list in browser local storage. The repository also contains discovery, brief review, dashboard, records, and guidance/visualization components; the sampled entry point does not show how those components are wired into the active page, so those relationships are left unverified. No server-side persistence is evidenced.

Main entry points: [`src/App.tsx`](https://github.com/hm186812/webbrief/blob/main/src/App.tsx) (App Shell), [`src/translations/i18n.ts`](https://github.com/hm186812/webbrief/blob/main/src/translations/i18n.ts) (Translations), [`src/components/AgencyDashboard.tsx`](https://github.com/hm186812/webbrief/blob/main/src/components/AgencyDashboard.tsx) (Agency Dashboard), [`src/components/CompactIntakeForm.tsx`](https://github.com/hm186812/webbrief/blob/main/src/components/CompactIntakeForm.tsx) (Compact Intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_app["App Shell<br/>[App.tsx]"]
  node_navbar["Navigation Bar<br/>[Navbar.tsx]"]
  node_brief_store[("Browser Storage")]
end

subgraph group_intake["Brief Intake"]
  node_intake_form["Compact Intake"]
  node_discovery["Discovery Wizard"]
  node_presets["Brief Presets<br/>[presets.ts]"]
  node_brief_model["Brief Model<br/>[brief.ts]"]
end

subgraph group_management["Brief Management"]
  node_agency_dashboard["Agency Dashboard"]
  node_brief_detail["Brief Detail"]
  node_compact_records["Compact Records<br/>[CompactRecords.tsx]"]
  node_contact_config["Contact Utilities<br/>[contactConfig.ts]"]
end

subgraph group_guides["Planning Guides"]
  node_style_visualizer["Style Visualizer"]
  node_standards_guide["Standards Guide<br/>[StandardsGuide.tsx]"]
  node_stack_guide["Technology Guide"]
  node_translations["Translations<br/>[i18n.ts]"]
end

node_client(("Client"))

node_client -->|"opens"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_intake_form
node_app -->|"reads and writes"| node_brief_store
node_intake_form -.->|"submits brief"| node_app
node_intake_form -.->|"uses contact settings"| node_contact_config
node_discovery -.->|"collects brief"| node_brief_model
node_agency_dashboard -.->|"opens details"| node_brief_detail
node_agency_dashboard -.->|"manages records"| node_compact_records
node_brief_detail -->|"formats contact message"| node_contact_config
node_style_visualizer -.->|"uses style options"| node_presets
node_standards_guide -.->|"uses standards"| node_presets
node_agency_dashboard -.->|"uses labels"| node_translations
node_brief_detail -->|"uses labels"| node_translations
node_discovery -.->|"uses labels"| node_translations
node_stack_guide -.->|"uses labels"| node_translations

click node_app "https://github.com/hm186812/webbrief/blob/main/src/App.tsx"
click node_navbar "https://github.com/hm186812/webbrief/blob/main/src/components/Navbar.tsx"
click node_intake_form "https://github.com/hm186812/webbrief/blob/main/src/components/CompactIntakeForm.tsx"
click node_discovery "https://github.com/hm186812/webbrief/blob/main/src/components/DiscoveryWizard.tsx"
click node_presets "https://github.com/hm186812/webbrief/blob/main/src/constants/presets.ts"
click node_brief_model "https://github.com/hm186812/webbrief/blob/main/src/types/brief.ts"
click node_agency_dashboard "https://github.com/hm186812/webbrief/blob/main/src/components/AgencyDashboard.tsx"
click node_brief_detail "https://github.com/hm186812/webbrief/blob/main/src/components/BriefDetailModal.tsx"
click node_compact_records "https://github.com/hm186812/webbrief/blob/main/src/components/CompactRecords.tsx"
click node_contact_config "https://github.com/hm186812/webbrief/blob/main/src/constants/contactConfig.ts"
click node_style_visualizer "https://github.com/hm186812/webbrief/blob/main/src/components/StyleVisualizer.tsx"
click node_standards_guide "https://github.com/hm186812/webbrief/blob/main/src/components/StandardsGuide.tsx"
click node_stack_guide "https://github.com/hm186812/webbrief/blob/main/src/components/ReactTechStackGuide.tsx"
click node_translations "https://github.com/hm186812/webbrief/blob/main/src/translations/i18n.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_app,node_navbar,node_brief_store,node_client toneBlue
class node_intake_form,node_discovery,node_presets,node_brief_model toneAmber
class node_agency_dashboard,node_brief_detail,node_compact_records,node_contact_config toneMint
class node_style_visualizer,node_standards_guide,node_stack_guide,node_translations toneRose
```

## Components

### Application Shell

- [App Shell](https://github.com/hm186812/webbrief/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation Bar](https://github.com/hm186812/webbrief/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- **Browser Storage**

### Brief Intake

- [Compact Intake](https://github.com/hm186812/webbrief/blob/main/src/components/CompactIntakeForm.tsx): `src/components/CompactIntakeForm.tsx`
- [Discovery Wizard](https://github.com/hm186812/webbrief/blob/main/src/components/DiscoveryWizard.tsx): `src/components/DiscoveryWizard.tsx`
- [Brief Presets](https://github.com/hm186812/webbrief/blob/main/src/constants/presets.ts): `src/constants/presets.ts`
- [Brief Model](https://github.com/hm186812/webbrief/blob/main/src/types/brief.ts): `src/types/brief.ts`

### Brief Management

- [Agency Dashboard](https://github.com/hm186812/webbrief/blob/main/src/components/AgencyDashboard.tsx): `src/components/AgencyDashboard.tsx`
- [Brief Detail](https://github.com/hm186812/webbrief/blob/main/src/components/BriefDetailModal.tsx): `src/components/BriefDetailModal.tsx`
- [Compact Records](https://github.com/hm186812/webbrief/blob/main/src/components/CompactRecords.tsx): `src/components/CompactRecords.tsx`
- [Contact Utilities](https://github.com/hm186812/webbrief/blob/main/src/constants/contactConfig.ts): `src/constants/contactConfig.ts`

### Planning Guides

- [Style Visualizer](https://github.com/hm186812/webbrief/blob/main/src/components/StyleVisualizer.tsx): `src/components/StyleVisualizer.tsx`
- [Standards Guide](https://github.com/hm186812/webbrief/blob/main/src/components/StandardsGuide.tsx): `src/components/StandardsGuide.tsx`
- [Technology Guide](https://github.com/hm186812/webbrief/blob/main/src/components/ReactTechStackGuide.tsx): `src/components/ReactTechStackGuide.tsx`
- [Translations](https://github.com/hm186812/webbrief/blob/main/src/translations/i18n.ts): `src/translations/i18n.ts`

### Other components

- **Client**

## Connections

- Client → App Shell: opens (evidence: `README.md`)
- App Shell → Navigation Bar: renders (evidence: `src/App.tsx`)
- App Shell → Compact Intake: renders (evidence: `src/App.tsx`)
- App Shell → Browser Storage: reads and writes (evidence: `src/App.tsx`)
- Compact Intake → App Shell: submits brief (evidence: `src/App.tsx`)
- Compact Intake → Contact Utilities: uses contact settings (evidence: `src/components/CompactIntakeForm.tsx`)
- Discovery Wizard → Brief Model: collects brief (evidence: `src/components/DiscoveryWizard.tsx`)
- Agency Dashboard → Brief Detail: opens details
- Agency Dashboard → Compact Records: manages records
- Brief Detail → Contact Utilities: formats contact message (evidence: `src/components/BriefDetailModal.tsx`)
- Style Visualizer → Brief Presets: uses style options (evidence: `src/components/StyleVisualizer.tsx`)
- Standards Guide → Brief Presets: uses standards (evidence: `src/components/StandardsGuide.tsx`)
- Agency Dashboard → Translations: uses labels (evidence: `src/components/AgencyDashboard.tsx`)
- Brief Detail → Translations: uses labels (evidence: `src/components/BriefDetailModal.tsx`)
- Discovery Wizard → Translations: uses labels (evidence: `src/components/DiscoveryWizard.tsx`)
- Technology Guide → Translations: uses labels (evidence: `src/components/ReactTechStackGuide.tsx`)
