How directus-labs/agency-os works
AgencyOS combines a public agency website with an authenticated client portal and agency operations features, using Nuxt as the frontend and Directus as its backend. A visitor searches or browses CMS content; a client can access project, task, file, and billing features in the portal. The README documents broader CRM, proposals, invoicing, and website capabilities than the sampled source shows. Search and Stripe webhook relationships are supported by excerpts; broader feature links are documented in the README.
Main entry points: index.ts Directus Integration · index.vue Project Workspace · [...permalink].vue Pages and Blog · search.get.ts Search API
Components 21
Public Website
- Pages and Blog
pages/[...permalink].vue - Page Builder
components/PageBuilder.vue - Help Center
pages/help/index.vue - Global Search
components/GlobalSearch.vue - Search API
server/api/search.get.ts
Client Portal
- Portal Pages
layers/portal/pages/portal.vue - Project Workspace
layers/portal/pages/portal/projects/[id]/index.vue - Task Management
layers/portal/components/TaskList.vue - Client Files
layers/portal/components/FilesView.vue - Client Billing
layers/portal/pages/portal/billing/index.vue - Stripe Checkout
layers/portal/server/api/stripe/create-checkout-session.post.ts - Stripe Webhook
layers/portal/server/api/stripe/webhooks.post.ts
Agency Operations
- Proposal Builder
layers/proposals/pages/proposals/[id].vue - CRM and Project Models
types/os
Platform and Content
- Directus Integration
modules/directus/index.ts - Directus Authentication
modules/directus/runtime/composables/useDirectusAuth.ts - CMS and Block Types
types/schema.ts
Other components
- Website Visitor
- Portal Client
- Directus Backend
- Stripe
Connections 18
- Website Visitor → Pages and Blog: browses
- Pages and Blog → Page Builder: renders blocks
- Website Visitor → Help Center: browses
- Global Search → Search API: requests results
components/GlobalSearch.vue - Search API → Directus Backend: queries content
server/api/search.get.ts - Portal Client → Portal Pages: accesses
- Portal Pages → Project Workspace: opens projects
- Project Workspace → Task Management: views tasks
- Project Workspace → Client Files: views files
- Portal Client → Client Billing: views invoices
- Client Billing → Stripe Checkout: starts payment
- Stripe → Stripe Webhook: sends events
layers/portal/server/api/stripe/webhooks.post.ts - Stripe Webhook → Directus Backend: records payment
layers/portal/server/api/stripe/webhooks.post.ts - Proposal Builder → CRM and Project Models: builds proposals
- Directus Integration → Directus Backend: connects SDK
modules/directus/index.ts - Directus Authentication → Directus Backend: authenticates users
modules/directus/runtime/composables/useDirectusAuth.ts - Directus Integration → CMS and Block Types: types schema
modules/directus/index.ts - Directus Integration → Directus Backend: loads globals and redirects
modules/directus/index.ts