How ravirraj/z0 works
Z0 is a self-hosted AI React-component generator. The main workflow takes a developer’s prompt and optional images through the chat UI, sends it to the v0 service, streams or returns generated chat content, and presents the result in a live preview. Users can authenticate, save and manage conversations, configure a personal v0 API key, and browse generated projects. Several links are documented or visible in the source index rather than in excerpts; those evidence limits are reflected in the graph.
Main entry points: queries.ts Database Queries · v0-client.ts v0 Client · home-client.tsx Prompt Workspace · route.ts Generation API
Components 24
Identity & Keys
- Login & Register
app/(auth)/login/page.tsx - Auth Form
components/auth-form.tsx - Auth Client
lib/auth-client.ts - Session Helper
app/(auth)/auth.ts - Auth Backend
lib/auth.ts - v0 Key API
app/api/user/v0-key/route.ts
Generation & Preview
- Prompt Workspace
components/home/home-client.tsx - Chat Input
components/chat/chat-input.tsx - Generation API
app/api/chat/route.ts - v0 Client
lib/v0-client.ts - Message Renderer
components/chat/chat-messages.tsx - Live Preview
components/chat/preview-panel.tsx - Preview Frame
components/ai-elements/web-preview.tsx - QR Sharing
components/dialogs/qr-code-dialog.tsx
Chat & Projects
- Chat Management APIs
app/api/chat - Chat List & Detail APIs
app/api/chats - Chat Pages
app/chats - Chat Detail UI
components/chats/chat-detail-client.tsx - Projects Dashboard
components/projects/projects-page.tsx - Project Queries
lib/projects.ts
Persistence
- PostgreSQL Data
lib/db/schema.ts - Database Queries
lib/db/queries.ts
Other components
- Developer
- v0 API
Connections 32
- Developer → Login & Register: signs in
README.md - Login & Register → Auth Form: renders
app/(auth)/login/page.tsx - Auth Form → Auth Client: authenticates with
components/auth-form.tsx - Auth Client → Auth Backend: uses session service
- Auth Backend → PostgreSQL Data: reads auth data
lib/auth.ts - Developer → Prompt Workspace: describes component
README.md - Prompt Workspace → Chat Input: renders
components/home/home-client.tsx - Prompt Workspace → Generation API: submits prompt
- Generation API → Session Helper: checks session
app/api/chat/route.ts - Generation API → Database Queries: checks limit; records owner
app/api/chat/route.ts - Generation API → v0 Client: requests generation
app/api/chat/route.ts - v0 Client → Database Queries: loads user key
lib/v0-client.ts - v0 Client → v0 API: calls SDK
lib/v0-client.ts - Generation API → Message Renderer: streams responses
- Prompt Workspace → Message Renderer: renders
components/home/home-client.tsx - Prompt Workspace → Live Preview: renders
components/home/home-client.tsx - Live Preview → Preview Frame: embeds preview
components/chat/preview-panel.tsx - Live Preview → QR Sharing: opens sharing
components/chat/preview-panel.tsx - Chat Pages → Chat Detail UI: renders
- Chat Detail UI → Chat Input: uses input
components/chats/chat-detail-client.tsx - Chat Detail UI → Message Renderer: renders messages
components/chats/chat-detail-client.tsx - Chat Detail UI → Live Preview: shows preview
components/chats/chat-detail-client.tsx - Chat Management APIs → Session Helper: checks session
app/api/chat/delete/route.ts - Chat Management APIs → Database Queries: manages ownership
app/api/chat/ownership/route.ts - Chat Management APIs → v0 Client: manages v0 chats
app/api/chat/fork/route.ts - Chat List & Detail APIs → Database Queries: loads chat records
app/api/chats/route.ts - Chat List & Detail APIs → v0 Client: accesses v0 chats
app/api/chats/route.ts - v0 Key API → Database Queries: stores key
app/api/user/v0-key/route.ts - v0 Key API → v0 Client: validates key
app/api/user/v0-key/route.ts - Projects Dashboard → Project Queries: loads projects
app/projects/page.tsx - Project Queries → Database Queries: reads chat data
- Database Queries → PostgreSQL Data: reads and writes
lib/db/queries.ts