# itzmeet2/wireframe architecture

> Architecture diagram of the GitHub repository itzmeet2/wireframe, 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/itzmeet2/wireframe
- Repository: https://github.com/itzmeet2/wireframe

## Overview

WireGen is a workspace-to-editable-studio application: users provide repository files or a brief, review detected product structure, generate a wireframe, workflow, or infographic, then edit and export the result. The graph separates intake, analysis, generation, and studio capabilities. Relationships are limited to calls or references visible in excerpts/index entries and capabilities explicitly documented in the README; some UI-to-API wiring is not shown.

Main entry points: [`src/app/page.tsx`](https://github.com/itzmeet2/wireframe/blob/master/src/app/page.tsx) (Studio Controller), [`src/lib/ai/service.ts`](https://github.com/itzmeet2/wireframe/blob/master/src/lib/ai/service.ts) (AI Generation Service), [`src/components/diagrams/WorkflowRenderer.tsx`](https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/WorkflowRenderer.tsx) (Workflow Renderer), [`src/components/left/WorkspaceTree.tsx`](https://github.com/itzmeet2/wireframe/blob/master/src/components/left/WorkspaceTree.tsx) (Workspace Intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Workspace Intake"]
  node_workspace_tree["Workspace Intake<br/>[WorkspaceTree.tsx]"]
  node_local_scan["Local Scanner<br/>[route.ts]"]
  node_git_scan["Git Scanner<br/>[route.ts]"]
  node_file_rules["File Filtering<br/>[fileFilter.ts]"]
  node_secret_redaction["Secret Redaction<br/>[redact.ts]"]
  node_stack_detect["Stack Detection<br/>[detector.ts]"]
  node_extractor_registry["Screen Extractors"]
  node_extractors["Stack Extractors"]
end

subgraph group_generation["Analysis &amp; Generation"]
  node_mode_detect["Mode Detection<br/>[modeDetector.ts]"]
  node_analysis_api["Workspace Analysis API<br/>[route.ts]"]
  node_diagram_api["Diagram Generation API<br/>[route.ts]"]
  node_screen_api["Screen Generation API<br/>[route.ts]"]
  node_ai_service["AI Generation Service<br/>[service.ts]"]
  node_validation["Spec Validation<br/>[diagramSchemas.ts]"]
  node_fallback["Heuristic Fallback"]
  node_layout["Workflow Layout<br/>[layoutEngine.ts]"]
  node_settings_api["Provider Settings<br/>[route.ts]"]
end

subgraph group_studio["Editing Studio"]
  node_studio_app["Studio Controller<br/>[page.tsx]"]
  node_wire_canvas["Wireframe Canvas"]
  node_workflow_view["Workflow Renderer"]
  node_infographic_view["Infographic Renderer"]
  node_service_icon["Service Icons<br/>[ServiceIcon.tsx]"]
  node_postprocess["Layout Post-Processor<br/>[postProcessor.ts]"]
end

subgraph group_delivery["Project &amp; Export"]
  node_project_store[("Project Persistence<br/>[projectStore.ts]")]
  node_export_ui["Export Controls<br/>[ExportModal.tsx]"]
  node_export_service["Export Service<br/>[exportService.ts]"]
  node_diagram_export["Diagram Exporter<br/>[diagramExporter.ts]"]
end

node_architect(("Workspace User"))
node_ai_providers["AI Providers"]

node_architect -->|"uses"| node_studio_app
node_studio_app -->|"renders"| node_workspace_tree
node_workspace_tree -->|"filters files"| node_file_rules
node_workspace_tree -->|"redacts content"| node_secret_redaction
node_local_scan -->|"filters files"| node_file_rules
node_local_scan -->|"redacts content"| node_secret_redaction
node_git_scan -->|"filters files"| node_file_rules
node_git_scan -->|"redacts content"| node_secret_redaction
node_studio_app -->|"detects stack"| node_stack_detect
node_stack_detect -->|"selects extractors"| node_extractor_registry
node_extractor_registry -->|"dispatches extraction"| node_extractors
node_studio_app -.->|"suggests modes"| node_mode_detect
node_analysis_api -->|"analyzes workspace"| node_ai_service
node_diagram_api -->|"generates diagrams"| node_ai_service
node_screen_api -->|"generates screens"| node_ai_service
node_ai_service -->|"validates specs"| node_validation
node_ai_service -->|"falls back"| node_fallback
node_ai_service -->|"lays out workflows"| node_layout
node_settings_api -->|"configures keys"| node_ai_providers
node_ai_service -->|"calls model"| node_ai_providers
node_studio_app -->|"presents editor"| node_wire_canvas
node_wire_canvas -->|"normalizes layout"| node_postprocess
node_studio_app -.->|"presents workflow"| node_workflow_view
node_studio_app -.->|"presents infographic"| node_infographic_view
node_workflow_view -->|"lays out nodes"| node_layout
node_workflow_view -->|"renders icons"| node_service_icon
node_infographic_view -->|"renders icons"| node_service_icon
node_infographic_view -->|"exports diagram"| node_diagram_export
node_workflow_view -->|"exports diagram"| node_diagram_export
node_studio_app -->|"persists project"| node_project_store
node_studio_app -->|"offers exports"| node_export_ui
node_export_ui -->|"requests export"| node_export_service

click node_studio_app "https://github.com/itzmeet2/wireframe/blob/master/src/app/page.tsx"
click node_workspace_tree "https://github.com/itzmeet2/wireframe/blob/master/src/components/left/WorkspaceTree.tsx"
click node_local_scan "https://github.com/itzmeet2/wireframe/blob/master/src/app/api/scan-local-path/route.ts"
click node_git_scan "https://github.com/itzmeet2/wireframe/blob/master/src/app/api/git/scan/route.ts"
click node_file_rules "https://github.com/itzmeet2/wireframe/blob/master/src/lib/scanner/fileFilter.ts"
click node_secret_redaction "https://github.com/itzmeet2/wireframe/blob/master/src/lib/scanner/redact.ts"
click node_stack_detect "https://github.com/itzmeet2/wireframe/blob/master/src/lib/stack/detector.ts"
click node_extractor_registry "https://github.com/itzmeet2/wireframe/blob/master/src/lib/stack/extractorRegistry.ts"
click node_extractors "https://github.com/itzmeet2/wireframe/tree/master/src/lib/stack/extractors"
click node_mode_detect "https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/modeDetector.ts"
click node_analysis_api "https://github.com/itzmeet2/wireframe/blob/master/src/app/api/analyze/route.ts"
click node_diagram_api "https://github.com/itzmeet2/wireframe/blob/master/src/app/api/generate-diagram/route.ts"
click node_screen_api "https://github.com/itzmeet2/wireframe/blob/master/src/app/api/generate-screen/route.ts"
click node_ai_service "https://github.com/itzmeet2/wireframe/blob/master/src/lib/ai/service.ts"
click node_validation "https://github.com/itzmeet2/wireframe/blob/master/src/lib/validation/diagramSchemas.ts"
click node_fallback "https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/heuristicGenerator.ts"
click node_layout "https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/layoutEngine.ts"
click node_wire_canvas "https://github.com/itzmeet2/wireframe/blob/master/src/components/canvas/KonvaCanvasStage.tsx"
click node_workflow_view "https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/WorkflowRenderer.tsx"
click node_infographic_view "https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/InfographicRenderer.tsx"
click node_service_icon "https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/ServiceIcon.tsx"
click node_postprocess "https://github.com/itzmeet2/wireframe/blob/master/src/lib/layout/postProcessor.ts"
click node_project_store "https://github.com/itzmeet2/wireframe/blob/master/src/lib/persistence/projectStore.ts"
click node_export_ui "https://github.com/itzmeet2/wireframe/blob/master/src/components/modals/ExportModal.tsx"
click node_export_service "https://github.com/itzmeet2/wireframe/blob/master/src/lib/export/exportService.ts"
click node_diagram_export "https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/diagramExporter.ts"
click node_settings_api "https://github.com/itzmeet2/wireframe/blob/master/src/app/api/settings/route.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_workspace_tree,node_local_scan,node_git_scan,node_file_rules,node_secret_redaction,node_stack_detect,node_extractor_registry,node_extractors,node_architect toneBlue
class node_mode_detect,node_analysis_api,node_diagram_api,node_screen_api,node_ai_service,node_validation,node_fallback,node_layout,node_settings_api toneAmber
class node_studio_app,node_wire_canvas,node_workflow_view,node_infographic_view,node_service_icon,node_postprocess toneMint
class node_project_store,node_export_ui,node_export_service,node_diagram_export toneRose
class node_ai_providers toneIndigo
```

## Components

### Workspace Intake

- [Workspace Intake](https://github.com/itzmeet2/wireframe/blob/master/src/components/left/WorkspaceTree.tsx): `src/components/left/WorkspaceTree.tsx`
- [Local Scanner](https://github.com/itzmeet2/wireframe/blob/master/src/app/api/scan-local-path/route.ts): `src/app/api/scan-local-path/route.ts`
- [Git Scanner](https://github.com/itzmeet2/wireframe/blob/master/src/app/api/git/scan/route.ts): `src/app/api/git/scan/route.ts`
- [File Filtering](https://github.com/itzmeet2/wireframe/blob/master/src/lib/scanner/fileFilter.ts): `src/lib/scanner/fileFilter.ts`
- [Secret Redaction](https://github.com/itzmeet2/wireframe/blob/master/src/lib/scanner/redact.ts): `src/lib/scanner/redact.ts`
- [Stack Detection](https://github.com/itzmeet2/wireframe/blob/master/src/lib/stack/detector.ts): `src/lib/stack/detector.ts`
- [Screen Extractors](https://github.com/itzmeet2/wireframe/blob/master/src/lib/stack/extractorRegistry.ts): `src/lib/stack/extractorRegistry.ts`
- [Stack Extractors](https://github.com/itzmeet2/wireframe/tree/master/src/lib/stack/extractors): `src/lib/stack/extractors`

### Analysis & Generation

- [Mode Detection](https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/modeDetector.ts): `src/lib/diagrams/modeDetector.ts`
- [Workspace Analysis API](https://github.com/itzmeet2/wireframe/blob/master/src/app/api/analyze/route.ts): `src/app/api/analyze/route.ts`
- [Diagram Generation API](https://github.com/itzmeet2/wireframe/blob/master/src/app/api/generate-diagram/route.ts): `src/app/api/generate-diagram/route.ts`
- [Screen Generation API](https://github.com/itzmeet2/wireframe/blob/master/src/app/api/generate-screen/route.ts): `src/app/api/generate-screen/route.ts`
- [AI Generation Service](https://github.com/itzmeet2/wireframe/blob/master/src/lib/ai/service.ts): `src/lib/ai/service.ts`
- [Spec Validation](https://github.com/itzmeet2/wireframe/blob/master/src/lib/validation/diagramSchemas.ts): `src/lib/validation/diagramSchemas.ts`
- [Heuristic Fallback](https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/heuristicGenerator.ts): `src/lib/diagrams/heuristicGenerator.ts`
- [Workflow Layout](https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/layoutEngine.ts): `src/lib/diagrams/layoutEngine.ts`
- [Provider Settings](https://github.com/itzmeet2/wireframe/blob/master/src/app/api/settings/route.ts): `src/app/api/settings/route.ts`

### Editing Studio

- [Studio Controller](https://github.com/itzmeet2/wireframe/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Wireframe Canvas](https://github.com/itzmeet2/wireframe/blob/master/src/components/canvas/KonvaCanvasStage.tsx): `src/components/canvas/KonvaCanvasStage.tsx`
- [Workflow Renderer](https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/WorkflowRenderer.tsx): `src/components/diagrams/WorkflowRenderer.tsx`
- [Infographic Renderer](https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/InfographicRenderer.tsx): `src/components/diagrams/InfographicRenderer.tsx`
- [Service Icons](https://github.com/itzmeet2/wireframe/blob/master/src/components/diagrams/ServiceIcon.tsx): `src/components/diagrams/ServiceIcon.tsx`
- [Layout Post-Processor](https://github.com/itzmeet2/wireframe/blob/master/src/lib/layout/postProcessor.ts): `src/lib/layout/postProcessor.ts`

### Project & Export

- [Project Persistence](https://github.com/itzmeet2/wireframe/blob/master/src/lib/persistence/projectStore.ts): `src/lib/persistence/projectStore.ts`
- [Export Controls](https://github.com/itzmeet2/wireframe/blob/master/src/components/modals/ExportModal.tsx): `src/components/modals/ExportModal.tsx`
- [Export Service](https://github.com/itzmeet2/wireframe/blob/master/src/lib/export/exportService.ts): `src/lib/export/exportService.ts`
- [Diagram Exporter](https://github.com/itzmeet2/wireframe/blob/master/src/lib/diagrams/diagramExporter.ts): `src/lib/diagrams/diagramExporter.ts`

### Other components

- **Workspace User**
- **AI Providers**

## Connections

- Workspace User → Studio Controller: uses (evidence: `README.md`)
- Studio Controller → Workspace Intake: renders (evidence: `src/app/page.tsx`)
- Workspace Intake → File Filtering: filters files (evidence: `src/components/left/WorkspaceTree.tsx`)
- Workspace Intake → Secret Redaction: redacts content (evidence: `src/components/left/WorkspaceTree.tsx`)
- Local Scanner → File Filtering: filters files (evidence: `src/app/api/scan-local-path/route.ts`)
- Local Scanner → Secret Redaction: redacts content (evidence: `src/app/api/scan-local-path/route.ts`)
- Git Scanner → File Filtering: filters files (evidence: `src/app/api/git/scan/route.ts`)
- Git Scanner → Secret Redaction: redacts content (evidence: `src/app/api/git/scan/route.ts`)
- Studio Controller → Stack Detection: detects stack (evidence: `src/app/page.tsx`)
- Stack Detection → Screen Extractors: selects extractors (evidence: `src/lib/stack/detector.ts`)
- Screen Extractors → Stack Extractors: dispatches extraction (evidence: `src/lib/stack/extractorRegistry.ts`)
- Studio Controller → Mode Detection: suggests modes (evidence: `src/app/page.tsx`)
- Workspace Analysis API → AI Generation Service: analyzes workspace (evidence: `src/app/api/analyze/route.ts`)
- Diagram Generation API → AI Generation Service: generates diagrams (evidence: `src/app/api/generate-diagram/route.ts`)
- Screen Generation API → AI Generation Service: generates screens (evidence: `src/app/api/generate-screen/route.ts`)
- AI Generation Service → Spec Validation: validates specs (evidence: `src/lib/ai/service.ts`)
- AI Generation Service → Heuristic Fallback: falls back (evidence: `src/lib/ai/service.ts`)
- AI Generation Service → Workflow Layout: lays out workflows (evidence: `src/lib/ai/service.ts`)
- Provider Settings → AI Providers: configures keys (evidence: `README.md`)
- AI Generation Service → AI Providers: calls model (evidence: `src/lib/ai/service.ts`)
- Studio Controller → Wireframe Canvas: presents editor (evidence: `README.md`)
- Wireframe Canvas → Layout Post-Processor: normalizes layout (evidence: `src/components/canvas/KonvaCanvasStage.tsx`)
- Studio Controller → Workflow Renderer: presents workflow (evidence: `src/app/page.tsx`)
- Studio Controller → Infographic Renderer: presents infographic (evidence: `src/app/page.tsx`)
- Workflow Renderer → Workflow Layout: lays out nodes (evidence: `src/components/diagrams/WorkflowRenderer.tsx`)
- Workflow Renderer → Service Icons: renders icons (evidence: `src/components/diagrams/WorkflowRenderer.tsx`)
- Infographic Renderer → Service Icons: renders icons (evidence: `src/components/diagrams/InfographicRenderer.tsx`)
- Infographic Renderer → Diagram Exporter: exports diagram (evidence: `src/components/diagrams/InfographicRenderer.tsx`)
- Workflow Renderer → Diagram Exporter: exports diagram (evidence: `src/components/diagrams/WorkflowRenderer.tsx`)
- Studio Controller → Project Persistence: persists project (evidence: `README.md`)
- Studio Controller → Export Controls: offers exports (evidence: `src/app/page.tsx`)
- Export Controls → Export Service: requests export (evidence: `src/components/modals/ExportModal.tsx`)
