# junglecruzr/promptframer1 architecture

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

- Interactive diagram: https://gitdiagram.com/junglecruzr/promptframer1
- Repository: https://github.com/junglecruzr/promptframer1

## Overview

Prompt Framer is a local-first desktop application for drafting prompts and producing project artifacts through five modes. The user launches the local app, works in its browser-based UI, and receives locally saved outputs or—where AI is involved—results from a configured model provider. The main workflow is routed through the HTTP server to mode-specific services; separate branches handle skill management, agent blueprints, and website generation. The sampled excerpts do not show all route handlers or browser API calls, so some UI-to-server relationships are documented rather than source-verified.

Main entry points: [`web_server.py`](https://github.com/junglecruzr/promptframer1/blob/main/web_server.py) (Local HTTP server), [`workflows/website_service.py`](https://github.com/junglecruzr/promptframer1/blob/main/workflows/website_service.py) (Website generation), [`workflows/skill_service.py`](https://github.com/junglecruzr/promptframer1/blob/main/workflows/skill_service.py) (Skill management), [`main.py`](https://github.com/junglecruzr/promptframer1/blob/main/main.py) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Local application"]
  node_main["Application entry<br/>[main.py]"]
  node_launcher["Browser launcher<br/>[ui_launcher.py]"]
  node_server["Local HTTP server<br/>[web_server.py]"]
  node_ui["Browser UI<br/>[app.js]"]
end

subgraph group_prompt["Prompt and blueprints"]
  node_quick["Quick prompts<br/>[iterative.js]"]
  node_prompt_service["Prompt generation<br/>[prompt_service.py]"]
  node_software_bp["Software blueprint"]
  node_project_model["Project blueprint model<br/>[models.py]"]
  node_agent_ui["Agent designer<br/>[agent-blueprint.js]"]
  node_agent_service["Agent blueprint service"]
  node_agent_model["Agent blueprint model"]
  node_scaffold["Python scaffold output<br/>[prompt_service.py]"]
end

subgraph group_skills["Skill library"]
  node_skill_ui["Skill creator UI<br/>[skills.js]"]
  node_skill_service["Skill management<br/>[skill_service.py]"]
  node_skill_model["Skill specification model<br/>[skill_models.py]"]
  node_skill_templates["Built-in skill library"]
end

subgraph group_websites["Website generation"]
  node_website_ui["Website generator UI<br/>[website.js]"]
  node_website_service["Website generation<br/>[website_service.py]"]
  node_website_model["Website specification<br/>[website_models.py]"]
  node_website_templates["Website templates"]
end

subgraph group_shared["Shared capabilities"]
  node_catalog["UI component catalog<br/>[ui_catalog.py]"]
  node_voice["Voice input<br/>[voice.js]"]
  node_config["App configuration<br/>[app_config.py]"]
  node_security["Security scanner<br/>[security_scan.py]"]
end

node_user(("User"))
node_provider{{"Configured model"}}

node_user -->|"launches"| node_main
node_main -->|"starts"| node_launcher
node_main -->|"starts"| node_server
node_main -->|"configures"| node_config
node_user -->|"uses"| node_ui
node_ui -.->|"sends requests"| node_server
node_server -->|"dispatches prompts"| node_prompt_service
node_prompt_service -->|"requests generation"| node_provider
node_server -->|"dispatches blueprint"| node_software_bp
node_software_bp -->|"parses and validates"| node_project_model
node_server -->|"dispatches agent blueprint"| node_agent_service
node_agent_service -->|"builds models"| node_agent_model
node_agent_service -->|"reads paths"| node_config
node_prompt_service -->|"generates"| node_scaffold
node_server -->|"dispatches skills"| node_skill_service
node_skill_service -->|"uses specifications"| node_skill_model
node_skill_service -->|"loads templates"| node_skill_templates
node_skill_service -->|"reads paths"| node_config
node_server -->|"dispatches websites"| node_website_service
node_website_service -->|"uses specifications"| node_website_model
node_website_service -->|"loads templates"| node_website_templates
node_website_service -->|"uses catalog"| node_catalog
node_website_service -->|"reads paths"| node_config
node_ui -.->|"uses voice input"| node_voice
node_ui -.->|"offers prompt modes"| node_quick
node_agent_ui -.->|"edits blueprints"| node_agent_service
node_skill_ui -.->|"manages skills"| node_skill_service
node_website_ui -.->|"requests websites"| node_website_service

click node_main "https://github.com/junglecruzr/promptframer1/blob/main/main.py"
click node_launcher "https://github.com/junglecruzr/promptframer1/blob/main/ui_launcher.py"
click node_server "https://github.com/junglecruzr/promptframer1/blob/main/web_server.py"
click node_ui "https://github.com/junglecruzr/promptframer1/blob/main/src/app.js"
click node_quick "https://github.com/junglecruzr/promptframer1/blob/main/src/iterative.js"
click node_prompt_service "https://github.com/junglecruzr/promptframer1/blob/main/prompt_service.py"
click node_software_bp "https://github.com/junglecruzr/promptframer1/blob/main/workflows/blueprint_service.py"
click node_project_model "https://github.com/junglecruzr/promptframer1/blob/main/workflows/models.py"
click node_agent_ui "https://github.com/junglecruzr/promptframer1/blob/main/src/agent-blueprint.js"
click node_agent_service "https://github.com/junglecruzr/promptframer1/blob/main/workflows/agent_blueprint_service.py"
click node_agent_model "https://github.com/junglecruzr/promptframer1/blob/main/workflows/agent_blueprint_models.py"
click node_scaffold "https://github.com/junglecruzr/promptframer1/blob/main/prompt_service.py"
click node_skill_ui "https://github.com/junglecruzr/promptframer1/blob/main/src/skills.js"
click node_skill_service "https://github.com/junglecruzr/promptframer1/blob/main/workflows/skill_service.py"
click node_skill_model "https://github.com/junglecruzr/promptframer1/blob/main/workflows/skill_models.py"
click node_skill_templates "https://github.com/junglecruzr/promptframer1/tree/main/workflows/templates/skills"
click node_website_ui "https://github.com/junglecruzr/promptframer1/blob/main/src/website.js"
click node_website_service "https://github.com/junglecruzr/promptframer1/blob/main/workflows/website_service.py"
click node_website_model "https://github.com/junglecruzr/promptframer1/blob/main/workflows/website_models.py"
click node_website_templates "https://github.com/junglecruzr/promptframer1/tree/main/workflows/templates/websites"
click node_catalog "https://github.com/junglecruzr/promptframer1/blob/main/workflows/ui_catalog.py"
click node_voice "https://github.com/junglecruzr/promptframer1/blob/main/src/voice.js"
click node_config "https://github.com/junglecruzr/promptframer1/blob/main/app_config.py"
click node_security "https://github.com/junglecruzr/promptframer1/blob/main/security_scan.py"

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_main,node_launcher,node_server,node_ui,node_user toneBlue
class node_quick,node_prompt_service,node_software_bp,node_project_model,node_agent_ui,node_agent_service,node_agent_model,node_scaffold toneAmber
class node_skill_ui,node_skill_service,node_skill_model,node_skill_templates toneMint
class node_website_ui,node_website_service,node_website_model,node_website_templates toneRose
class node_catalog,node_voice,node_config,node_security,node_provider toneIndigo
```

## Components

### Local application

- [Application entry](https://github.com/junglecruzr/promptframer1/blob/main/main.py): `main.py`
- [Browser launcher](https://github.com/junglecruzr/promptframer1/blob/main/ui_launcher.py): `ui_launcher.py`
- [Local HTTP server](https://github.com/junglecruzr/promptframer1/blob/main/web_server.py): `web_server.py`
- [Browser UI](https://github.com/junglecruzr/promptframer1/blob/main/src/app.js): `src/app.js`

### Prompt and blueprints

- [Quick prompts](https://github.com/junglecruzr/promptframer1/blob/main/src/iterative.js): `src/iterative.js`
- [Prompt generation](https://github.com/junglecruzr/promptframer1/blob/main/prompt_service.py): `prompt_service.py`
- [Software blueprint](https://github.com/junglecruzr/promptframer1/blob/main/workflows/blueprint_service.py): `workflows/blueprint_service.py`
- [Project blueprint model](https://github.com/junglecruzr/promptframer1/blob/main/workflows/models.py): `workflows/models.py`
- [Agent designer](https://github.com/junglecruzr/promptframer1/blob/main/src/agent-blueprint.js): `src/agent-blueprint.js`
- [Agent blueprint service](https://github.com/junglecruzr/promptframer1/blob/main/workflows/agent_blueprint_service.py): `workflows/agent_blueprint_service.py`
- [Agent blueprint model](https://github.com/junglecruzr/promptframer1/blob/main/workflows/agent_blueprint_models.py): `workflows/agent_blueprint_models.py`
- [Python scaffold output](https://github.com/junglecruzr/promptframer1/blob/main/prompt_service.py): `prompt_service.py`

### Skill library

- [Skill creator UI](https://github.com/junglecruzr/promptframer1/blob/main/src/skills.js): `src/skills.js`
- [Skill management](https://github.com/junglecruzr/promptframer1/blob/main/workflows/skill_service.py): `workflows/skill_service.py`
- [Skill specification model](https://github.com/junglecruzr/promptframer1/blob/main/workflows/skill_models.py): `workflows/skill_models.py`
- [Built-in skill library](https://github.com/junglecruzr/promptframer1/tree/main/workflows/templates/skills): `workflows/templates/skills`

### Website generation

- [Website generator UI](https://github.com/junglecruzr/promptframer1/blob/main/src/website.js): `src/website.js`
- [Website generation](https://github.com/junglecruzr/promptframer1/blob/main/workflows/website_service.py): `workflows/website_service.py`
- [Website specification](https://github.com/junglecruzr/promptframer1/blob/main/workflows/website_models.py): `workflows/website_models.py`
- [Website templates](https://github.com/junglecruzr/promptframer1/tree/main/workflows/templates/websites): `workflows/templates/websites`

### Shared capabilities

- [UI component catalog](https://github.com/junglecruzr/promptframer1/blob/main/workflows/ui_catalog.py): `workflows/ui_catalog.py`
- [Voice input](https://github.com/junglecruzr/promptframer1/blob/main/src/voice.js): `src/voice.js`
- [App configuration](https://github.com/junglecruzr/promptframer1/blob/main/app_config.py): `app_config.py`
- [Security scanner](https://github.com/junglecruzr/promptframer1/blob/main/security_scan.py): `security_scan.py`

### Other components

- **User**
- **Configured model**

## Connections

- User → Application entry: launches (evidence: `README.md`)
- Application entry → Browser launcher: starts (evidence: `main.py`)
- Application entry → Local HTTP server: starts (evidence: `main.py`)
- Application entry → App configuration: configures (evidence: `README.md`)
- User → Browser UI: uses (evidence: `README.md`)
- Browser UI → Local HTTP server: sends requests
- Local HTTP server → Prompt generation: dispatches prompts (evidence: `web_server.py`)
- Prompt generation → Configured model: requests generation (evidence: `prompt_service.py`)
- Local HTTP server → Software blueprint: dispatches blueprint (evidence: `web_server.py`)
- Software blueprint → Project blueprint model: parses and validates (evidence: `workflows/blueprint_service.py`)
- Local HTTP server → Agent blueprint service: dispatches agent blueprint (evidence: `README.md`)
- Agent blueprint service → Agent blueprint model: builds models (evidence: `workflows/agent_blueprint_service.py`)
- Agent blueprint service → App configuration: reads paths (evidence: `workflows/agent_blueprint_service.py`)
- Prompt generation → Python scaffold output: generates (evidence: `prompt_service.py`)
- Local HTTP server → Skill management: dispatches skills (evidence: `README.md`)
- Skill management → Skill specification model: uses specifications (evidence: `workflows/skill_service.py`)
- Skill management → Built-in skill library: loads templates (evidence: `workflows/skill_service.py`)
- Skill management → App configuration: reads paths (evidence: `workflows/skill_service.py`)
- Local HTTP server → Website generation: dispatches websites (evidence: `README.md`)
- Website generation → Website specification: uses specifications (evidence: `workflows/website_service.py`)
- Website generation → Website templates: loads templates (evidence: `workflows/website_service.py`)
- Website generation → UI component catalog: uses catalog (evidence: `workflows/website_service.py`)
- Website generation → App configuration: reads paths (evidence: `workflows/website_service.py`)
- Browser UI → Voice input: uses voice input
- Browser UI → Quick prompts: offers prompt modes
- Agent designer → Agent blueprint service: edits blueprints
- Skill creator UI → Skill management: manages skills
- Website generator UI → Website generation: requests websites
