How abdullahzaher/vibress works
Vibress is a self-hostable CMS and publication platform. Staff manage content, themes, settings, plugins, and monetization in the Admin SPA; members use the Portal; readers consume the SSR public site. These clients call the Fastify API, which owns domain operations and persists state, while background workers handle queued work such as email, webhooks, analytics, and search indexing. The README documents the broad runtime topology and capabilities; source excerpts provide additional evidence for storage, theme, and search details. Many domain routes and integrations are unsampled, so their internal links are omitted.
Main entry points: src/main.ts REST API · connection.ts PostgreSQL · src/main.ts Background Workers · App.tsx Admin SPA
Components 21
User Applications
- Admin SPA
apps/admin/src/app/App.tsx - Member Portal
apps/portal/src/router.tsx - Public SSR Site
apps/web/src/app/page.tsx
API and Domains
- REST API
apps/api/src/main.ts - Content Management
apps/api/src/routes/content.ts - Membership and Billing
apps/api/src/routes/admin-billing.ts - Collaborative Editing
apps/api/src/collaboration/room-manager.ts - Media Storage
packages/domains/storage/src/application/storage-service.ts
Publishing and Themes
- Studio Editor
packages/studio-core/src/index.ts - Theme Rendering
packages/theme-core/src/theme-engine.ts - Search Indexing
apps/worker/src/processors/search-indexer-worker.ts - Localization
packages/i18n/src/translation-service.ts
Persistence and Workers
- PostgreSQL
packages/database/src/connection.ts - Redis Queue
packages/queue/src/index.ts - Background Workers
apps/worker/src/main.ts - S3 Provider
packages/storage-s3/src/s3-storage-provider.ts
Extensions
- Plugin Runtime
apps/api/src/plugins/plugin-host.ts - Scoped Plugin Storage
packages/domains/plugins/src/application/plugin-scoped-storage.ts
Other components
- Staff
- Members
- Readers
Connections 25
- Staff → Admin SPA: manages
README.md - Admin SPA → REST API: calls
README.md - Members → Member Portal: uses
README.md - Member Portal → REST API: calls
README.md - Readers → Public SSR Site: reads
README.md - Public SSR Site → REST API: fetches content
README.md - REST API → Content Management: routes content
README.md - REST API → Membership and Billing: routes billing
README.md - REST API → PostgreSQL: persists
README.md - REST API → Redis Queue: enqueues work
README.md - Content Management → PostgreSQL: reads and writes
- Membership and Billing → PostgreSQL: persists
- Admin SPA → Studio Editor: edits blocks
README.md - Collaborative Editing → Studio Editor: syncs documents
README.md - Background Workers → Redis Queue: consumes jobs
README.md - Background Workers → PostgreSQL: updates data
README.md - Background Workers → Search Indexing: runs indexing
apps/worker/src/main.ts - Search Indexing → PostgreSQL: indexes content
apps/worker/src/processors/search-indexer-worker.ts - REST API → Media Storage: handles uploads
- Media Storage → S3 Provider: uses provider
packages/domains/storage/src/application/storage-service.ts - Theme Rendering → Localization: formats locales
packages/theme-core/src/theme-engine.ts - Public SSR Site → Theme Rendering: renders themes
- REST API → Plugin Runtime: hosts extensions
README.md - Plugin Runtime → Scoped Plugin Storage: accesses scoped data
- Scoped Plugin Storage → PostgreSQL: reads and writes