# firecrawl/open-lovable architecture

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

- Interactive diagram: https://gitdiagram.com/firecrawl/open-lovable
- Repository: https://github.com/firecrawl/open-lovable

## Overview

Open Lovable is a browser-based AI app builder: users describe or request edits to a React app, the service generates or applies code, and the app runs in a sandbox for preview. The repository also exposes Firecrawl-oriented search and scraping endpoints and homepage affordances. The excerpts substantiate generation context selection, fast edits, and sandbox-provider selection; most endpoint-to-UI wiring and several endpoint internals were not sampled, so those relationships are omitted or marked unverified.

Main entry points: [`app/page.tsx`](https://github.com/firecrawl/open-lovable/blob/main/app/page.tsx) (Home and search UI), [`app/generation/page.tsx`](https://github.com/firecrawl/open-lovable/blob/main/app/generation/page.tsx) (App builder UI), [`app/api/generate-ai-code-stream/route.ts`](https://github.com/firecrawl/open-lovable/blob/main/app/api/generate-ai-code-stream/route.ts) (Code generation stream), [`app/api/apply-ai-code-stream/route.ts`](https://github.com/firecrawl/open-lovable/blob/main/app/api/apply-ai-code-stream/route.ts) (Code application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_builder["Builder experience"]
  node_home["Home and search UI<br/>[page.tsx]"]
  node_generation["App builder UI<br/>[page.tsx]"]
  node_preview["Live preview frame"]
end

subgraph group_ai["AI code workflow"]
  node_generate["Code generation stream<br/>[route.ts]"]
  node_apply["Code application<br/>[route.ts]"]
  node_editintent["Edit intent analysis"]
  node_context["Context selection"]
  node_searchplan["File search execution"]
  node_fastapply["Morph fast apply"]
  node_provider["AI provider clients"]
end

subgraph group_sandbox["Sandbox runtime"]
  node_create["Sandbox creation<br/>[route.ts]"]
  node_manager["Sandbox manager<br/>[sandbox-manager.ts]"]
  node_factory["Provider factory<br/>[factory.ts]"]
  node_vercel["Vercel sandbox<br/>[vercel-provider.ts]"]
  node_e2b["E2B sandbox<br/>[e2b-provider.ts]"]
end

subgraph group_webdata["Search and scraping"]
  node_searchapi["Search endpoint<br/>[route.ts]"]
  node_scrape["Website scraping<br/>[route.ts]"]
  node_enhancedscrape["Enhanced URL scrape<br/>[route.ts]"]
  node_screenshot["Scrape screenshot<br/>[route.ts]"]
end

node_user(("User"))

node_user -->|"starts search"| node_home
node_user -->|"describes app"| node_generation
node_generation -.->|"requests generation"| node_generate
node_generate -->|"loads context"| node_context
node_generate -->|"executes search plan"| node_searchplan
node_generate -.->|"selects model"| node_provider
node_generation -.->|"requests code apply"| node_apply
node_apply -->|"parses and applies edits"| node_fastapply
node_apply -->|"uses sandbox"| node_manager
node_generation -.->|"starts sandbox"| node_create
node_create -.->|"creates sandbox"| node_vercel
node_manager -->|"creates provider"| node_factory
node_factory -->|"selects provider"| node_vercel
node_factory -->|"selects provider"| node_e2b
node_generation -.->|"shows running app"| node_preview
node_home -.->|"submits search"| node_searchapi
node_home -.->|"submits site scrape"| node_scrape
node_home -.->|"requests URL scrape"| node_enhancedscrape
node_home -.->|"requests screenshot"| node_screenshot

click node_home "https://github.com/firecrawl/open-lovable/blob/main/app/page.tsx"
click node_generation "https://github.com/firecrawl/open-lovable/blob/main/app/generation/page.tsx"
click node_preview "https://github.com/firecrawl/open-lovable/blob/main/components/shared/preview/live-preview-frame.tsx"
click node_generate "https://github.com/firecrawl/open-lovable/blob/main/app/api/generate-ai-code-stream/route.ts"
click node_apply "https://github.com/firecrawl/open-lovable/blob/main/app/api/apply-ai-code-stream/route.ts"
click node_editintent "https://github.com/firecrawl/open-lovable/blob/main/lib/edit-intent-analyzer.ts"
click node_context "https://github.com/firecrawl/open-lovable/blob/main/lib/context-selector.ts"
click node_searchplan "https://github.com/firecrawl/open-lovable/blob/main/lib/file-search-executor.ts"
click node_fastapply "https://github.com/firecrawl/open-lovable/blob/main/lib/morph-fast-apply.ts"
click node_provider "https://github.com/firecrawl/open-lovable/blob/main/lib/ai/provider-manager.ts"
click node_create "https://github.com/firecrawl/open-lovable/blob/main/app/api/create-ai-sandbox/route.ts"
click node_manager "https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/sandbox-manager.ts"
click node_factory "https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/factory.ts"
click node_vercel "https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/providers/vercel-provider.ts"
click node_e2b "https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/providers/e2b-provider.ts"
click node_searchapi "https://github.com/firecrawl/open-lovable/blob/main/app/api/search/route.ts"
click node_scrape "https://github.com/firecrawl/open-lovable/blob/main/app/api/scrape-website/route.ts"
click node_enhancedscrape "https://github.com/firecrawl/open-lovable/blob/main/app/api/scrape-url-enhanced/route.ts"
click node_screenshot "https://github.com/firecrawl/open-lovable/blob/main/app/api/scrape-screenshot/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_home,node_generation,node_preview,node_user toneBlue
class node_generate,node_apply,node_editintent,node_context,node_searchplan,node_fastapply,node_provider toneAmber
class node_create,node_manager,node_factory,node_vercel,node_e2b toneMint
class node_searchapi,node_scrape,node_enhancedscrape,node_screenshot toneRose
```

## Components

### Builder experience

- [Home and search UI](https://github.com/firecrawl/open-lovable/blob/main/app/page.tsx): `app/page.tsx`
- [App builder UI](https://github.com/firecrawl/open-lovable/blob/main/app/generation/page.tsx): `app/generation/page.tsx`
- [Live preview frame](https://github.com/firecrawl/open-lovable/blob/main/components/shared/preview/live-preview-frame.tsx): `components/shared/preview/live-preview-frame.tsx`

### AI code workflow

- [Code generation stream](https://github.com/firecrawl/open-lovable/blob/main/app/api/generate-ai-code-stream/route.ts): `app/api/generate-ai-code-stream/route.ts`
- [Code application](https://github.com/firecrawl/open-lovable/blob/main/app/api/apply-ai-code-stream/route.ts): `app/api/apply-ai-code-stream/route.ts`
- [Edit intent analysis](https://github.com/firecrawl/open-lovable/blob/main/lib/edit-intent-analyzer.ts): `lib/edit-intent-analyzer.ts`
- [Context selection](https://github.com/firecrawl/open-lovable/blob/main/lib/context-selector.ts): `lib/context-selector.ts`
- [File search execution](https://github.com/firecrawl/open-lovable/blob/main/lib/file-search-executor.ts): `lib/file-search-executor.ts`
- [Morph fast apply](https://github.com/firecrawl/open-lovable/blob/main/lib/morph-fast-apply.ts): `lib/morph-fast-apply.ts`
- [AI provider clients](https://github.com/firecrawl/open-lovable/blob/main/lib/ai/provider-manager.ts): `lib/ai/provider-manager.ts`

### Sandbox runtime

- [Sandbox creation](https://github.com/firecrawl/open-lovable/blob/main/app/api/create-ai-sandbox/route.ts): `app/api/create-ai-sandbox/route.ts`
- [Sandbox manager](https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/sandbox-manager.ts): `lib/sandbox/sandbox-manager.ts`
- [Provider factory](https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/factory.ts): `lib/sandbox/factory.ts`
- [Vercel sandbox](https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/providers/vercel-provider.ts): `lib/sandbox/providers/vercel-provider.ts`
- [E2B sandbox](https://github.com/firecrawl/open-lovable/blob/main/lib/sandbox/providers/e2b-provider.ts): `lib/sandbox/providers/e2b-provider.ts`

### Search and scraping

- [Search endpoint](https://github.com/firecrawl/open-lovable/blob/main/app/api/search/route.ts): `app/api/search/route.ts`
- [Website scraping](https://github.com/firecrawl/open-lovable/blob/main/app/api/scrape-website/route.ts): `app/api/scrape-website/route.ts`
- [Enhanced URL scrape](https://github.com/firecrawl/open-lovable/blob/main/app/api/scrape-url-enhanced/route.ts): `app/api/scrape-url-enhanced/route.ts`
- [Scrape screenshot](https://github.com/firecrawl/open-lovable/blob/main/app/api/scrape-screenshot/route.ts): `app/api/scrape-screenshot/route.ts`

### Other components

- **User**

## Connections

- User → Home and search UI: starts search (evidence: `app/page.tsx`)
- User → App builder UI: describes app (evidence: `README.md`)
- App builder UI → Code generation stream: requests generation
- Code generation stream → Context selection: loads context (evidence: `app/api/generate-ai-code-stream/route.ts`)
- Code generation stream → File search execution: executes search plan (evidence: `app/api/generate-ai-code-stream/route.ts`)
- Code generation stream → AI provider clients: selects model
- App builder UI → Code application: requests code apply
- Code application → Morph fast apply: parses and applies edits (evidence: `app/api/apply-ai-code-stream/route.ts`)
- Code application → Sandbox manager: uses sandbox (evidence: `app/api/apply-ai-code-stream/route.ts`)
- App builder UI → Sandbox creation: starts sandbox
- Sandbox creation → Vercel sandbox: creates sandbox
- Sandbox manager → Provider factory: creates provider (evidence: `lib/sandbox/sandbox-manager.ts`)
- Provider factory → Vercel sandbox: selects provider (evidence: `lib/sandbox/factory.ts`)
- Provider factory → E2B sandbox: selects provider (evidence: `lib/sandbox/factory.ts`)
- App builder UI → Live preview frame: shows running app
- Home and search UI → Search endpoint: submits search
- Home and search UI → Website scraping: submits site scrape
- Home and search UI → Enhanced URL scrape: requests URL scrape
- Home and search UI → Scrape screenshot: requests screenshot
