# bernietv/lovable-clone architecture

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

- Interactive diagram: https://gitdiagram.com/bernietv/lovable-clone
- Repository: https://github.com/bernietv/lovable-clone

## Overview

Lovable Clone is an AI app-generation workspace. Users authenticate, create or open a project, submit a prompt, and inspect generated files alongside a live preview. The documented background-job and agent capabilities are represented, but the sampled excerpts do not reveal the full generation-to-sandbox implementation or all model integrations; those links are marked as documented rather than source-verified.

Main entry points: [`src/inngest/functions.ts`](https://github.com/bernietv/lovable-clone/blob/main/src/inngest/functions.ts) (Generation jobs), [`src/trpc/routers/_app.ts`](https://github.com/bernietv/lovable-clone/blob/main/src/trpc/routers/_app.ts) (API router), [`src/modules/projects/ui/views/project-view.tsx`](https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/views/project-view.tsx) (Project view), [`src/app/(home)/page.tsx`](https://github.com/bernietv/lovable-clone/blob/main/src/app/(home)/page.tsx) (Project home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and projects"]
  node_auth["Clerk auth<br/>[page.tsx]"]
  node_home["Project home<br/>[page.tsx]"]
  node_projectform["Project form<br/>[project-form.tsx]"]
  node_projectlist["Project list<br/>[projects-list.tsx]"]
end

subgraph group_api["API and persistence"]
  node_trpc["tRPC endpoint<br/>[route.ts]"]
  node_router["API router<br/>[_app.ts]"]
  node_projectproc["Project procedures<br/>[procedures.ts]"]
  node_messageproc["Message procedures<br/>[procedures.ts]"]
  node_usageproc["Usage procedure<br/>[procedure.ts]"]
  node_database[("Prisma database<br/>[prisma.ts]")]
  node_usage["Credit tracking<br/>[usage.ts]"]
end

subgraph group_generation["Async generation"]
  node_eventroute["Inngest endpoint<br/>[route.ts]"]
  node_inngest["Inngest client<br/>[client.ts]"]
  node_worker["Generation jobs<br/>[functions.ts]"]
  node_prompt["Generation prompt<br/>[prompt.ts]"]
end

subgraph group_workspace["Project workspace"]
  node_projectroute["Project route<br/>[page.tsx]"]
  node_projectview["Project view<br/>[project-view.tsx]"]
  node_messagesui["Messages UI"]
  node_messageform["Message form<br/>[message-form.tsx]"]
  node_preview["Live preview<br/>[fragment-web.tsx]"]
  node_explorer["Code explorer<br/>[file-explorer.tsx]"]
  node_tree["File tree<br/>[tree-view.tsx]"]
end

node_user(("User"))
node_ai{{"AI models"}}
node_sandbox{{"Cloud sandbox"}}

node_user -->|"signs in"| node_auth
node_user -->|"manages projects"| node_home
node_home -->|"renders"| node_projectform
node_home -->|"renders"| node_projectlist
node_projectform -.->|"submits project"| node_trpc
node_trpc -->|"dispatches"| node_router
node_router -->|"routes projects"| node_projectproc
node_router -->|"routes messages"| node_messageproc
node_router -->|"routes usage"| node_usageproc
node_projectproc -->|"reads and writes"| node_database
node_projectproc -->|"checks credits"| node_usage
node_messageproc -->|"reads and writes"| node_database
node_messageproc -->|"checks credits"| node_usage
node_projectroute -->|"renders"| node_projectview
node_projectview -->|"renders"| node_messagesui
node_projectview -->|"renders"| node_preview
node_projectview -->|"renders"| node_explorer
node_messagesui -.->|"renders"| node_messageform
node_explorer -->|"renders"| node_tree
node_eventroute -->|"serves jobs"| node_inngest
node_eventroute -->|"registers"| node_worker
node_worker -->|"uses prompt"| node_prompt
node_worker -->|"reads and writes"| node_database
node_worker -.->|"generates code"| node_ai
node_worker -.->|"runs project"| node_sandbox
node_preview -.->|"loads preview"| node_sandbox

click node_auth "https://github.com/bernietv/lovable-clone/blob/main/src/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx"
click node_home "https://github.com/bernietv/lovable-clone/blob/main/src/app/(home)/page.tsx"
click node_projectform "https://github.com/bernietv/lovable-clone/blob/main/src/modules/home/ui/components/project-form.tsx"
click node_projectlist "https://github.com/bernietv/lovable-clone/blob/main/src/modules/home/ui/components/projects-list.tsx"
click node_projectroute "https://github.com/bernietv/lovable-clone/blob/main/src/app/projects/%5BprojectId%5D/page.tsx"
click node_projectview "https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/views/project-view.tsx"
click node_messagesui "https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/components/messages-container.tsx"
click node_messageform "https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/components/message-form.tsx"
click node_preview "https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/components/fragment-web.tsx"
click node_explorer "https://github.com/bernietv/lovable-clone/blob/main/src/components/file-explorer.tsx"
click node_tree "https://github.com/bernietv/lovable-clone/blob/main/src/components/tree-view.tsx"
click node_trpc "https://github.com/bernietv/lovable-clone/blob/main/src/app/api/trpc/%5Btrpc%5D/route.ts"
click node_router "https://github.com/bernietv/lovable-clone/blob/main/src/trpc/routers/_app.ts"
click node_projectproc "https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/server/procedures.ts"
click node_messageproc "https://github.com/bernietv/lovable-clone/blob/main/src/modules/messages/server/procedures.ts"
click node_usageproc "https://github.com/bernietv/lovable-clone/blob/main/src/modules/usage/server/procedure.ts"
click node_database "https://github.com/bernietv/lovable-clone/blob/main/src/lib/prisma.ts"
click node_usage "https://github.com/bernietv/lovable-clone/blob/main/src/lib/usage.ts"
click node_eventroute "https://github.com/bernietv/lovable-clone/blob/main/src/app/api/inngest/route.ts"
click node_inngest "https://github.com/bernietv/lovable-clone/blob/main/src/inngest/client.ts"
click node_worker "https://github.com/bernietv/lovable-clone/blob/main/src/inngest/functions.ts"
click node_prompt "https://github.com/bernietv/lovable-clone/blob/main/src/prompt.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_auth,node_home,node_projectform,node_projectlist,node_user toneBlue
class node_trpc,node_router,node_projectproc,node_messageproc,node_usageproc,node_database,node_usage toneAmber
class node_eventroute,node_inngest,node_worker,node_prompt toneMint
class node_projectroute,node_projectview,node_messagesui,node_messageform,node_preview,node_explorer,node_tree toneRose
class node_ai,node_sandbox toneIndigo
```

## Components

### Access and projects

- [Clerk auth](https://github.com/bernietv/lovable-clone/blob/main/src/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx): `src/app/(auth)/sign-in/[[...sign-in]]/page.tsx`
- [Project home](https://github.com/bernietv/lovable-clone/blob/main/src/app/(home)/page.tsx): `src/app/(home)/page.tsx`
- [Project form](https://github.com/bernietv/lovable-clone/blob/main/src/modules/home/ui/components/project-form.tsx): `src/modules/home/ui/components/project-form.tsx`
- [Project list](https://github.com/bernietv/lovable-clone/blob/main/src/modules/home/ui/components/projects-list.tsx): `src/modules/home/ui/components/projects-list.tsx`

### API and persistence

- [tRPC endpoint](https://github.com/bernietv/lovable-clone/blob/main/src/app/api/trpc/%5Btrpc%5D/route.ts): `src/app/api/trpc/[trpc]/route.ts`
- [API router](https://github.com/bernietv/lovable-clone/blob/main/src/trpc/routers/_app.ts): `src/trpc/routers/_app.ts`
- [Project procedures](https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/server/procedures.ts): `src/modules/projects/server/procedures.ts`
- [Message procedures](https://github.com/bernietv/lovable-clone/blob/main/src/modules/messages/server/procedures.ts): `src/modules/messages/server/procedures.ts`
- [Usage procedure](https://github.com/bernietv/lovable-clone/blob/main/src/modules/usage/server/procedure.ts): `src/modules/usage/server/procedure.ts`
- [Prisma database](https://github.com/bernietv/lovable-clone/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Credit tracking](https://github.com/bernietv/lovable-clone/blob/main/src/lib/usage.ts): `src/lib/usage.ts`

### Async generation

- [Inngest endpoint](https://github.com/bernietv/lovable-clone/blob/main/src/app/api/inngest/route.ts): `src/app/api/inngest/route.ts`
- [Inngest client](https://github.com/bernietv/lovable-clone/blob/main/src/inngest/client.ts): `src/inngest/client.ts`
- [Generation jobs](https://github.com/bernietv/lovable-clone/blob/main/src/inngest/functions.ts): `src/inngest/functions.ts`
- [Generation prompt](https://github.com/bernietv/lovable-clone/blob/main/src/prompt.ts): `src/prompt.ts`

### Project workspace

- [Project route](https://github.com/bernietv/lovable-clone/blob/main/src/app/projects/%5BprojectId%5D/page.tsx): `src/app/projects/[projectId]/page.tsx`
- [Project view](https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/views/project-view.tsx): `src/modules/projects/ui/views/project-view.tsx`
- [Messages UI](https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/components/messages-container.tsx): `src/modules/projects/ui/components/messages-container.tsx`
- [Message form](https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/components/message-form.tsx): `src/modules/projects/ui/components/message-form.tsx`
- [Live preview](https://github.com/bernietv/lovable-clone/blob/main/src/modules/projects/ui/components/fragment-web.tsx): `src/modules/projects/ui/components/fragment-web.tsx`
- [Code explorer](https://github.com/bernietv/lovable-clone/blob/main/src/components/file-explorer.tsx): `src/components/file-explorer.tsx`
- [File tree](https://github.com/bernietv/lovable-clone/blob/main/src/components/tree-view.tsx): `src/components/tree-view.tsx`

### Other components

- **User**
- **AI models**
- **Cloud sandbox**

## Connections

- User → Clerk auth: signs in (evidence: `README.md`)
- User → Project home: manages projects (evidence: `src/app/(home)/page.tsx`)
- Project home → Project form: renders (evidence: `src/app/(home)/page.tsx`)
- Project home → Project list: renders (evidence: `src/app/(home)/page.tsx`)
- Project form → tRPC endpoint: submits project
- tRPC endpoint → API router: dispatches (evidence: `src/app/api/trpc/[trpc]/route.ts`)
- API router → Project procedures: routes projects (evidence: `src/trpc/routers/_app.ts`)
- API router → Message procedures: routes messages (evidence: `src/trpc/routers/_app.ts`)
- API router → Usage procedure: routes usage (evidence: `src/trpc/routers/_app.ts`)
- Project procedures → Prisma database: reads and writes (evidence: `src/modules/projects/server/procedures.ts`)
- Project procedures → Credit tracking: checks credits (evidence: `src/modules/projects/server/procedures.ts`)
- Message procedures → Prisma database: reads and writes (evidence: `src/modules/messages/server/procedures.ts`)
- Message procedures → Credit tracking: checks credits (evidence: `src/modules/messages/server/procedures.ts`)
- Project route → Project view: renders (evidence: `src/app/projects/[projectId]/page.tsx`)
- Project view → Messages UI: renders (evidence: `src/modules/projects/ui/views/project-view.tsx`)
- Project view → Live preview: renders (evidence: `src/modules/projects/ui/views/project-view.tsx`)
- Project view → Code explorer: renders (evidence: `src/modules/projects/ui/views/project-view.tsx`)
- Messages UI → Message form: renders
- Code explorer → File tree: renders (evidence: `src/components/file-explorer.tsx`)
- Inngest endpoint → Inngest client: serves jobs (evidence: `src/app/api/inngest/route.ts`)
- Inngest endpoint → Generation jobs: registers (evidence: `src/app/api/inngest/route.ts`)
- Generation jobs → Generation prompt: uses prompt (evidence: `src/inngest/functions.ts`)
- Generation jobs → Prisma database: reads and writes (evidence: `src/inngest/functions.ts`)
- Generation jobs → AI models: generates code (evidence: `README.md`)
- Generation jobs → Cloud sandbox: runs project (evidence: `README.md`)
- Live preview → Cloud sandbox: loads preview (evidence: `README.md`)
