Creation of an open source tool to version and synchronize Directus configuration across environments
460+
GitHub stars
38
releases published since 2023
15 800+
npm downloads over 30 days (May 2026)
Directus-Sync is the open source command-line tool TRACTR created to version and synchronize the configuration of Directus instances (roles, permissions, flows, dashboards, translations…) between development, staging and production. It has been published on GitHub since 2023.
View the productAt a glance
- TypeScript
- Node.js
- Directus
- npm
Context and challenges
A Directus project lives in several environments. Without a tool, its configuration is copied by hand from one to the other, with gaps and omissions. Directus-Sync treats it as code: it is extracted into files, versioned in Git, compared and applied to another instance. It works with an extension installed on the Directus instance, described in its documentation.
What we did
Three commands
pull retrieves the configuration of an instance, diff compares it with the files of the repository, push applies it to another instance.
All the configuration tracked
Dashboards, flows, folders, operations, panels, permissions, policies, presets, roles, settings and translations.
Targeted synchronization
Each collection can be included or excluded: you synchronize exactly what you want to move.
Dependencies handled
Stable synchronization identifiers link the items from one instance to the other, and dependencies, circular ones included, are handled automatically.
Seed data and hooks
The tool also manages seed data, and hooks let you adapt each step of the synchronization.
Open and tested code
The code is published under the GPL-3.0 license, with online documentation and automated end-to-end and unit tests.
Where to find it
More case studies
Open Startup · Community and events · Podcast and annual event
Creation of a startup open house event and of a podcast that tell the story of the ecosystem
Geev · Consumer · Mobile and web app
Creation of the first Android app and the back end of an item donation platform
5M+ downloads on Google Play
Blues Web · Health and social services · Mobile app, web console
Redesign of an app that tracks young people’s daily lives, connected to their care team
The next step
What are we moving forward together?
An idea, an existing product, a task that takes too long. Tell us where you're starting from.
Let's talk about your projectA first conversation to understand your context.