strapi-plugin-config-sync
v3.1.0
Published
Migrate your config data across environments using the CLI or Strapi admin panel.
Downloads
32,470
Readme
Read the documentation
✨ Features
- CLI -
config-sync
CLI for syncing the config from the command line - GUI - Settings page for syncing the config in Strapi admin
- Partial sync - Import or export only specific portions of config
- Custom types - Include your custom collection types in the sync process
- Import on bootstrap - Easy automated deployment with
importOnBootstrap
- Exclusion - Exclude single config entries or all entries of a given type
- Diff viewer - A git-style diff viewer to inspect the config changes
⏳ Getting started
Read the Getting Started tutorial or follow the steps below:
# using yarn
yarn add strapi-plugin-config-sync
# using npm
npm install strapi-plugin-config-sync --save
Add the export path to the watchIgnoreFiles
list in the config/admin.js
file.
This way your app won't reload when you export the config in development.
config/admin.js
:
module.exports = ({ env }) => ({
// ...
watchIgnoreFiles: [
'**/config/sync/**',
],
});
After successful installation you have to rebuild the admin UI so it'll include this plugin. To rebuild and restart Strapi run:
# using yarn
yarn build
yarn develop
# using npm
npm run build
npm run develop
The Config Sync plugin should now appear in the Settings section of your Strapi app.
To start tracking your config changes you have to make the first export. This will dump all your configuration data to the /config/sync
directory. You can export either through the CLI or Strapi admin panel
Enjoy 🎉
📓 Documentation
See our dedicated repository for all of PluginPal's documentation, or view the Config Sync documentation live:
🤝 Contributing
Feel free to fork and make a pull request of this plugin. All the input is welcome!
⭐️ Show your support
Give a star if this project helped you.
🔗 Links
🌎 Community support
- For general help using Strapi, please refer to the official Strapi documentation.
- For support with this plugin you can DM me in the Strapi Discord channel.