How inkloom-art/inkloom works
Inkloom is an early-access platform for a future logo-design product; logo generation is explicitly not live. The present user journey is to learn about the service, create and secure an account, redeem an access code, and see reserved credits. The repository also includes user and operations consoles, an API, persistence, and operational monitoring. Edges are limited to relationships shown in the README or source excerpts/index; several route-level connections remain unverified because their implementations were not sampled.
Main entry points: app.ts Worker entry · auth/auth.ts Authentication service · client.ts Postgres database · routes/auth.ts Authentication routes
Components 21
Web experience
- Web application
apps/web/app/routes - Marketing pages
apps/web/app/routes/marketing - Account flows
apps/web/app/routes/auth - Member console
apps/web/app/routes/app - Operations console
apps/web/app/routes/admin
API services
- Worker entry
apps/web/workers/app.ts - API application
packages/api/src/index.ts - Authentication routes
packages/api/src/routes/auth.ts - Access middleware
packages/api/src/middleware/auth.ts
Account and credits
- Authentication service
packages/core/src/auth/auth.ts - Session policy
packages/core/src/auth/session-policy.ts - Access-code redemption
packages/core/src/access-codes/redemption.ts - Credit ledger
packages/core/src/credits/ledger.ts
Data and messaging
- Postgres database
packages/db/src/client.ts - Account schema
packages/db/src/schema/auth.ts - Email delivery
packages/email/src/transport.ts
Operations
- Telemetry rollup
packages/core/src/telemetry/rollup.ts - Retention sweep
packages/core/src/retention/sweep.ts - Health checks
packages/core/src/health/index.ts
Other components
- Visitor
- Member
Connections 21
- Visitor → Marketing pages: browses
- Member → Account flows: creates account
- Member → Member console: uses
- Web application → Worker entry: served by
- Worker entry → API application: dispatches API
apps/web/workers/app.ts - API application → Authentication routes: routes requests
- Authentication routes → Authentication service: uses authentication
packages/api/src/routes/auth.ts - Authentication routes → Email delivery: sends messages
packages/api/src/routes/auth.ts - Authentication routes → Postgres database: accesses data
packages/api/src/routes/auth.ts - Access middleware → Authentication service: validates sessions
packages/api/src/middleware/auth.ts - Access middleware → Session policy: checks session policy
packages/api/src/middleware/auth.ts - Authentication service → Postgres database: persists account data
packages/core/src/auth/auth.ts - Authentication service → Email delivery: sends messages
packages/core/src/auth/auth.ts - Authentication service → Session policy: uses session rules
packages/core/src/auth/auth.ts - Access-code redemption → Credit ledger: records credit entry
packages/core/src/access-codes/redemption.ts - Access-code redemption → Postgres database: persists redemption
packages/core/src/access-codes/redemption.ts - Credit ledger → Postgres database: reads and writes
packages/core/src/credits/ledger.ts - Account schema → Postgres database: defines account tables
- Worker entry → Telemetry rollup: runs daily rollup
apps/web/workers/app.ts - Worker entry → Retention sweep: runs sweep
apps/web/workers/app.ts - Worker entry → Health checks: checks health
apps/web/workers/app.ts