How mahadi-rsio/pagex works
PageX is a multi-tenant static-site hosting platform. The main workflow is a developer using the CLI to authenticate, initialize a project, build and validate site files, then prepare a deployment, upload blobs, and commit it. The console exposes project, deployment, and account operations; the blob server delivers hosted content, while worker code supports background cleanup and provisioning. CLI deployment calls are excerpted; several server-side connections are inferred from the product structure and are shown as unverified. The README excerpt describes publishing the blob server, not the full runtime architecture.
Main entry points: deployHandler.ts Deploy handler · deployApi.ts Deploy API client · consumer.go Worker runtime · ProjectDetailView.tsx Console UI
Components 26
CLI and deployment
- CLI entry
cli/src/index.ts - Commands
cli/src/commands/index.ts - Device login
cli/src/auth/deviceAuth.ts - Session store
cli/src/utils/session.ts - Build runner
cli/src/utils/buildHandler.ts - Deploy handler
cli/src/utils/deployHandler.ts - Manifest validation
cli/src/utils/validateManifest.ts - Deploy API client
cli/src/api/deployApi.ts - Authenticated API client
cli/src/api/client.ts
Console and API
- Auth service
- Console UI
services/console/src/components/console/views/ProjectDetailView.tsx - Deploy endpoints
services/console/src/app/api/deploy/prepare/route.ts - Deployment service
services/console/src/features/deployments/deploy.service.ts - Project endpoints
services/console/src/app/api/pages/route.ts - Project service
services/console/src/features/projects/page.service.ts - Usage services
services/console/src/features/usage/usage.service.ts - Usage ingestion
services/console/src/features/usage/usage-ingest.service.ts - Application database
services/console/src/db/schema.ts
Hosting and delivery
- Blob server
services/blob-server/src/handler.go - Object storage
services/console/src/server/api/infrastructure/storage/minio.ts
Background operations
- Worker runtime
services/worker/internal/worker/consumer.go - Deployment cleanup
services/worker/internal/cleanup/deployment_gc.go - Cloud provisioning
services/worker/internal/cloudflare/provision.go - Job queue
services/worker/internal/cloudflare/queue.go
Other components
- Developer
- Site visitor
Connections 26
- Developer → CLI entry: runs commands
cli/src/index.ts - CLI entry → Commands: registers
cli/src/index.ts - Device login → Auth service: requests authorization
cli/src/auth/deviceAuth.ts - Device login → Session store: saves token
cli/src/auth/deviceAuth.ts - Session store → Auth service: checks session
cli/src/utils/session.ts - Deploy handler → Manifest validation: validates files
cli/src/utils/deployHandler.ts - Deploy handler → Deploy API client: prepares deployment
cli/src/utils/deployHandler.ts - Deploy handler → Deploy API client: requests upload URLs
cli/src/utils/deployHandler.ts - Deploy handler → Deploy API client: uploads blobs
cli/src/utils/deployHandler.ts - Deploy handler → Deploy API client: commits deployment
cli/src/utils/deployHandler.ts - Deploy API client → Authenticated API client: sends API requests
cli/src/api/deployApi.ts - Authenticated API client → Session store: reads token
cli/src/api/client.ts - Deploy handler → Build runner: runs project build
- Developer → Console UI: manages projects
- Console UI → Project endpoints: requests project data
- Console UI → Deploy endpoints: requests deployments
- Project endpoints → Project service: delegates project work
- Deploy endpoints → Deployment service: delegates deployment work
- Deployment service → Object storage: stores deployment blobs
- Project service → Application database: persists project data
- Usage ingestion → Usage services: records usage
- Site visitor → Blob server: requests site content
- Blob server → Object storage: fetches blobs
- Worker runtime → Job queue: consumes jobs
- Worker runtime → Deployment cleanup: runs cleanup
- Worker runtime → Cloud provisioning: provisions hosting