Agency OS
The open source operating system for digital agencies. Built with Directus and Nuxt.
Automatically checked · GitHub checked 2026-11-13

Good fit for
Digital agencies comfortable customizing a Nuxt and Directus application.
Before you switch
This is a customizable application foundation; plan for configuration, development, hosting, and maintenance.
Overview
AgencyOS
AgencyOS is everything you need to get your agency off the ground, or improve tooling for your existing company. Nuxt 3 Website / Application + Directus Backend.
Brought to you by partnership magic between Directus and NuxtLabs.
Introduction · Features · Installation and Development · Deployment · Tech Stack · Community Help · Contributing
Introduction
One of the easiest parts of running a successful digital agency is doing the actual work. I mean - who doesn't love to put their head down to collaborate, design, and build amazing stuff for clients?
The hard bits are everything else that goes along with that – managing large projects with tons of moving pieces, communicating with clients to properly manage expectations, ensuring you're paid on time, and more.
When every billable hour counts, you don't have the time to build your own tools from scratch. And you shouldn't be forced to settle for off-the-shelf tech that falls short of your preferred workflow.
AgencyOS is the open source operating system to help you run (or start) your digital agency. It's built on open source tools (Nuxt and Directus) and designed to be 100% hackable so you can build YOUR solution, YOUR project management app, YOUR agency's operating system – in record time.
Why?
Quite a few folks on the Directus core team have experience running agencies and we know it's not all rainbows and sunshine. We wanted to build an tool that our agency partners (and any other agency) would get a lot of value from. It was also created as a complete example to showcase the power and flexibility of Directus as a platform to rapidly build your own apps and tools.
Getting Started
Features
Website
When you're hard at work delivering for clients - your own site tends to suffer. AgencyOS includes beautiful website template that's easily customizable and already integrated with an easy-to-use headless CMS.
It's not a starter template. It's a complete website project for you customize or inspire you to build an even better solution.
- Dynamic page builder with live preview
- Blog posts and categories
- Dynamic form generation with validation
- Dynamic OG image generation
- Full SEO support out of the box – (meta tags, sitemap, redirects, JSON-LD, and more)
- Global search functionality
- Common utilities so you don't need to include yet another package
- Google Fonts support
- ESLint and Prettier pre-configured
- Full dark mode support
- Themeable with easy config file
CRM / Project Tracker
Maintaining important client relationships doesn't just fall to the sales team. So why maintain separate project management and CRM tools? AgencyOS includes a completely customizable CRM so you can work the way you want.
- Organizations and contacts
- Sales pipeline and activities
- Dynamic project proposal builder
- Project and task management
- Customizable project templates
- Invoicing and expense tracking
- Customize and build your own dashboards without writing code
- Automate processes using Directus Flows
Client Portal
Communication is probably the biggest driver of project success. With AgencyOS's private client portal - you can insure your clients stay up to date and even hold them accountable for delivering the files and information you need to complete their project
- Private authenticated portal for clients to self-serve
- Clients can view their projects, tasks, and files
- Clients can pay invoices through Stripe
- Assign tasks to clients as part of project templates
Installation and Development
AgencyOS is structured as a monorepo with two main parts:
directus/– Directus backend (Docker Compose + template data)nuxt/– Nuxt 3 frontend (website + client portal)
Project Structure
agency-os/
├── directus/ # Directus backend
│ ├── docker-compose.yaml
│ ├── .env.example
│ ├── run-scripts/ # Flow operation scripts
│ └── template/ # Directus schema and sample content
├── nuxt/ # Nuxt 3 frontend
│ ├── package.json
│ ├── nuxt.config.ts
│ └── ...
├── package.json # Root config (directus:template metadata)
└── README.md
Quick Start (Recommended)
The fastest way to get started is with the Directus Template CLI:
npx directus-template-cli@latest init --template=https://github.com/directus-labs/agency-os
This sets up both the Directus backend (Directus 11) and the Nuxt frontend for you. Before starting the frontend, create a
static token for the admin user (see step 2) and set it as
DIRECTUS_SERVER_TOKEN in nuxt/.env.
Manual Setup
1 - Set Up Directus Backend
There are two ways to get a Directus instance running:
Option A - Directus Cloud
The easiest option. Register at directus.cloud and create a new project. Directus offers a 14 day free trial which is plenty of time to try AgencyOS. See pricing for details.
Option B - Self-Host with Docker
PostgreSQL is the tested and preferred database for this project.
cd directus
cp .env.example .env
docker compose up -d
# Directus will be available at http://localhost:8055/
You'll need Docker installed. See the Directus Docker Guide for more details.
Important Note: Community self-hosted instances are not covered by Directus support. For enterprise support, contact the Directus team.
2 - Generate a Static Token for the Admin User
You need a static token to seed the project with the template data.
- Go to the User Directory in your Directus instance
- Choose the Administrative User
- Scroll down to the Token field
- Generate token and copy it
- Save the user (don't forget to save!)
3 - Apply the AgencyOS Template
The Directus template lives in this repo at directus/template. Open your terminal, run the
following command, and follow the prompts.
npx directus-template-cli@latest apply
- Choose
From a public GitHub repository. - Paste
https://github.com/directus-labs/agency-os/tree/main/directus/template - Paste the URL to your Directus instance
- Paste your Admin user static token
- Wait for the script to finish
Or apply it in one command:
npx directus-template-cli@latest apply -p \
--directusUrl="http://localhost:8055" \
--directusToken="your-static-token" \
--templateType="github" \
--templateLocation="https://github.com/directus-labs/agency-os/tree/main/directus/template"
Learn more about the Directus Template CLI.
4 - Set Up the Nuxt Frontend
cd nuxt
cp .env.example .env
Update the .env with your Directus URL and token.
pnpm install
pnpm dev
Visit http://localhost:3000
To build for production:
pnpm build
Deployment
Deploying the Nuxt Frontend
Please check the official Nuxt Deployment Documentation for supported providers. Here are a few popular options:
One Click Options
Note: When deploying, set the Root Directory to nuxt/ in your hosting provider's settings.
Vercel
Netlify
Note: For Netlify, set the Base directory to nuxt/ in your site settings.
Deploying the Directus Backend
If you don't want to mess with DevOps, spin up a project on Directus Cloud in about 90 seconds.
For self-hosting, Docker is the recommended approach. See the Directus Docker Guide.
Resources for Self Hosting Directus
Tech Stack
Nuxt
Build your next Vue.js application with confidence using Nuxt. An open source framework under MIT license that makes web development simple and powerful.
Directus
Directus is a headless CMS that instantly turns your SQL database into REST and GraphQL APIs and gives you a beautiful, intuitive no-code app to manage all your content and data.
UI
- Nuxt UI - Official UI component library for Nuxt.
- Tailwind CSS – Utility-first CSS framework with Typography and Forms plugins.
- Headless UI – Fully accessible, unstyled UI components.
- FormKit – Form library for Vue with validation, theming, and schema generation.
- Nuxt Icon - Icon component with thousands of icons via Iconify.
Utilities
- VueUse – Collection of Vue Composition Utilities.
- VueUse Motion – Composables for component animations.
Community Help
- Directus Discord – Join over 10k+ developers for questions and discussion.
- Nuxt Discord
Contributing
AgencyOS is a community driven project so we'd love to have your contributions.
- Open an issue if you believe you've encountered a bug.
- Make a pull request to add new features or fix bugs.
Thanks To
AgencyOS was created by Bryant Gillespie (@bryantgillespie). But big thank yous are owed to...
- @rijkvanzanten and @benhaynes for building Directus and including me on the journey.
- @atinux and @alexchopin for creating the Nuxt framework.
- @intevel and @becem-gharbi for each of their separate
nuxt-directusmodules which served as source of inspiration.