How crowpus/zelyq works
Zelyq is an AI-assisted application-building workspace: users describe a project, the agent plans and edits it through tools, runs a project preview, and verifies the result. The web app also exposes image/video generation, account and team settings, and integrations. The graph combines the documented product workflow with relationships visible in the excerpts and source index; several server route-to-service and storage links are not shown in the sampled code, so those are omitted rather than inferred.
Main entry points: app.ts HTTP platform · App.tsx Web application · session.ts Agent turn loop · ProjectEditorPage.tsx Project editor
Components 22
Workspace
- Web application
apps/web/src/App.tsx - Session state
apps/web/src/hooks/useSession.ts - Project editor
apps/web/src/pages/ProjectEditorPage.tsx - Live preview
apps/web/src/components/PreviewPanel.tsx - Project list
apps/web/src/pages/ProjectListPage.tsx - Account settings
apps/web/src/pages/SettingsPage.tsx - Image Studio
apps/web/src/pages/ImageStudioPage.tsx - Video Studio
apps/web/src/pages/VideoStudioPage.tsx
Agent workflow
- Agent API
apps/agent/src/server.ts - Agent turn loop
apps/agent/src/session.ts - Prompt and modes
apps/agent/src/prompt.ts - Agent tools
packages/tools/src/orchestrate.ts - Model providers
apps/agent/src/providers/index.ts
Platform services
- HTTP platform
apps/server/src/app.ts - Agent client
apps/server/src/services/agent-client.ts - Project services
apps/server/src/services/projects.ts - Preview routes
apps/server/src/routes/preview.ts - Image generation
apps/server/src/services/image-generation.ts - Video generation
apps/server/src/services/video-generation.ts
Project execution
- Project runtime
packages/runtime/src/container.ts
Persistence
- Application database
packages/db/src/client.ts
Other components
- Builder
Connections 25
- Builder → Web application: uses
README.md - Web application → Session state: reads session
apps/web/src/App.tsx - Web application → Project editor: routes to
apps/web/src/App.tsx - Web application → Project list: routes to
apps/web/src/App.tsx - Web application → Account settings: routes to
apps/web/src/App.tsx - Web application → Image Studio: routes to
apps/web/src/App.tsx - Web application → Video Studio: routes to
apps/web/src/App.tsx - Project editor → Live preview: shows preview
- Session state → HTTP platform: requests session
- Project editor → HTTP platform: sends project work
- Image Studio → HTTP platform: requests generation
- Video Studio → HTTP platform: requests generation
- HTTP platform → Preview routes: registers
apps/server/src/app.ts - Preview routes → Project runtime: starts preview
apps/server/src/routes/preview.ts - Preview routes → Project services: checks access
apps/server/src/routes/preview.ts - HTTP platform → Image generation: configures
apps/server/src/app.ts - HTTP platform → Video generation: configures
apps/server/src/app.ts - HTTP platform → Agent client: connects agent
apps/server/src/app.ts - Agent client → Agent API: calls agent API
apps/server/src/services/agent-client.ts - Agent API → Agent turn loop: runs turns
apps/agent/src/server.ts - Agent turn loop → Prompt and modes: builds prompts
apps/agent/src/session.ts - Agent turn loop → Agent tools: executes tools
apps/agent/src/session.ts - Agent turn loop → Model providers: requests model output
apps/agent/src/session.ts - Agent turn loop → Project runtime: operates project
- Project services → Application database: stores project data