How prajexec/deployr works
DeployService accepts deployments through its dashboard or REST API, records them, and queues isolated builds. Workers build and publish static artifacts while emitting live logs; users can monitor, cancel, or roll back deployments. The router serves preview and current project releases from artifact storage. The graph combines sampled call sites with README-documented service responsibilities; unsampled subsystem internals are represented only where the README supports them.
Main entry points: server.ts REST API · builder.ts Sandbox builder · deployments.ts Deployment records · index.ts Queue consumer
Components 25
User entry points
- Web dashboard
apps/web/src/App.tsx - SSE client
apps/web/src/sse-client.ts
Deployment API
- REST API
apps/api/src/server.ts - Job producer
apps/api/src/queue.ts - Log stream manager
apps/api/src/log-stream-manager.ts
Build processing
- Queue consumer
apps/worker/src/index.ts - Job processor
apps/worker/src/processor.ts - Sandbox builder
apps/worker/src/builder.ts - Archive extractor
apps/worker/src/tar-extractor.ts - Build log writer
apps/worker/src/stream-writer.ts - Crash recovery
apps/worker/src/recovery.ts - Resource cleanup
apps/worker/src/cleanup.ts
Shared services
- Deployment records
packages/shared/src/db/deployments.ts - Status transitions
packages/shared/src/state-machine.ts - Project schema
packages/shared/src/db/schema.ts - Redis client
packages/shared/src/redis.ts - Artifact storage client
packages/shared/src/storage.ts
Static delivery
- Wildcard router
apps/router/src/server.ts
Other components
- Operator
- REST client
- Docker runtime
- PostgreSQL
- Redis
- S3-compatible storage
- Site visitor
Connections 29
- Operator → Web dashboard: uses
README.md - Operator → REST client: triggers deploy
README.md - Web dashboard → REST API: calls API
README.md - REST client → REST API: submits deployment
README.md - REST API → Deployment records: creates records
apps/api/src/server.ts - REST API → Job producer: enqueues build
apps/api/src/server.ts - Job producer → Queue consumer: dispatches job
README.md - Queue consumer → Job processor: processes job
apps/worker/src/index.ts - Job processor → Sandbox builder: runs build
apps/worker/src/processor.ts - Sandbox builder → Archive extractor: extracts archives
apps/worker/src/builder.ts - Sandbox builder → Docker runtime: runs isolated build
README.md - Sandbox builder → Artifact storage client: uploads artifacts
apps/worker/src/builder.ts - Sandbox builder → Build log writer: writes build logs
apps/worker/src/builder.ts - Build log writer → Redis client: appends log stream
apps/worker/src/stream-writer.ts - Redis client → Redis: connects to
README.md - Queue consumer → Crash recovery: recovers stuck jobs
apps/worker/src/index.ts - Queue consumer → Resource cleanup: schedules cleanup
apps/worker/src/index.ts - REST API → Log stream manager: serves live logs
README.md - Log stream manager → Redis client: reads log streams
README.md - Web dashboard → SSE client: streams logs
apps/web/src/App.tsx - SSE client → REST API: opens SSE stream
- Deployment records → Status transitions: checks transitions
packages/shared/src/db/deployments.ts - Deployment records → Project schema: queries tables
packages/shared/src/db/deployments.ts - Deployment records → PostgreSQL: reads and writes
README.md - Wildcard router → Deployment records: resolves releases
apps/router/src/server.ts - Wildcard router → Artifact storage client: fetches site assets
apps/router/src/server.ts - Artifact storage client → S3-compatible storage: reads and writes objects
packages/shared/src/storage.ts - Site visitor → Wildcard router: requests deployed site
README.md - REST API → Artifact storage client: reads archived logs
apps/api/src/server.ts