How sumitverma77/plinth-platform works
Plinth is a portfolio-building control plane: people sign in, create a portfolio, edit its workspace in the Web IDE, preview changes, and publish. The Next.js admin communicates with a NestJS API; a separate worker consumes background queues and integrates with GitHub. The graph preserves documented billing, integration catalogue, AI copilot, and administration capabilities. Some subsystem links are based on the README or SOURCE INDEX references; unsampled implementations and their internal call paths are not inferred.
Main entry points: api.ts API client · src Background worker · portfolios.service.ts Provisioning · preview.service.ts Preview lifecycle
Components 23
User experience
- Next.js admin
admin/app - API client
admin/lib/api.ts - Preview controls
admin/lib/usePreview.ts
Identity and account
- Authentication
backend/src/auth/auth.service.ts - Auth routes
backend/src/auth/auth.controller.ts
Portfolio lifecycle
- Portfolio setup
backend/src/provisioning/portfolios.controller.ts - Provisioning
backend/src/provisioning/portfolios.service.ts - Workspace editing
backend/src/workspace/workspace.service.ts - Edit operations
backend/src/operations/operations.service.ts - Preview routes
backend/src/sandbox/preview.controller.ts - Preview lifecycle
backend/src/sandbox/preview.service.ts - Publish
backend/src/operations/publish.controller.ts - AI copilot
backend/src/copilot
Platform services
- Integration catalogue
backend/src/catalogue/catalogue.controller.ts - Billing
backend/src/billing/billing.controller.ts - Admin tools
backend/src/admin/admin.controller.ts - Legal requests
backend/src/legal/legal.controller.ts - Background worker
backend/src
Persistence and queues
- PostgreSQL
backend/src/prisma/prisma.service.ts - Background queues
backend/src/queue/queue.module.ts
Other components
- Portfolio builder
- GitHub
- Vercel hosting
Connections 26
- Portfolio builder → Next.js admin: uses
README.md - Next.js admin → API client: requests through
admin/lib/api.ts - API client → Auth routes: sends HTTP requests
admin/lib/api.ts - Auth routes → Authentication: delegates to
backend/src/auth/auth.controller.ts - Authentication → PostgreSQL: upserts users
backend/src/auth/auth.service.ts - API client → Portfolio setup: calls API
- Portfolio setup → Provisioning: delegates to
backend/src/provisioning/portfolios.controller.ts - Provisioning → PostgreSQL: persists portfolio data
- Provisioning → Background queues: enqueues work
- Background worker → Background queues: consumes jobs
README.md - Background worker → GitHub: creates repositories
README.md - API client → Workspace editing: uses workspace API
- API client → Edit operations: submits edits
- Preview controls → API client: calls preview API
admin/lib/usePreview.ts - API client → Preview routes: sends preview requests
- Preview routes → Preview lifecycle: delegates to
backend/src/sandbox/preview.controller.ts - Preview lifecycle → Background queues: enqueues sandbox jobs
backend/src/sandbox/preview.service.ts - Preview lifecycle → PostgreSQL: reads portfolio data
backend/src/sandbox/preview.service.ts - API client → Publish: calls publish API
- Publish → Workspace editing: uses workspace
backend/src/operations/publish.controller.ts - Background worker → Vercel hosting: deploys portfolios
README.md - API client → AI copilot: uses copilot API
- API client → Integration catalogue: uses catalogue API
- API client → Billing: uses billing API
- API client → Admin tools: uses admin API
- API client → Legal requests: submits legal requests