BoilerDrop

BackdropCMS project boilerplate.

/!\ This is a work in progress. Always backup your stuff before testing new tools. Contributions are welcome. /!\

File structure

.
├── README.md
├── .gitignore
├── config
│   ├── active (*ignored*)
│   ├── staging (*ignored*)
│   └── versioned (**versioned**)
├── docroot (Your website lives here)
    └── drush/yourproject.aliases.drushrc.php
└── scripts
    ├── create_project
    ├── fix_permissions
    ├── config_export
    ├── config_import
    ├── update_local_from_dev
    └── update_local_from_prod

Usage

Clone this repository:

git clone https://github.com/opi/boilerdrop

Use the create_project script to automatically download sources, translations and create local settings and drush aliases files.
Usage:

./scripts/create_project <project_name> <language>

Use lando for a quick development server. A .lando.yml file is already configured for you. Usage:

lando start

Configuration managment settings

Use the following configuration in your settings.php file.

$config_directories['active'] = '../config/active';
$config_directories['staging'] = '../config/staging';

Ressources:

• http://www.jenlampton.com/blog/managing-backdrop-cms-config-files-git
• backdrop/backdrop-issues#855 (comment)

Configuration managment usage

Export (development process)

./scripts/config_export

It will export current configuration into the config/versioned folder. Use git diff to review changes.

Import (in production)

./scripts/config_import

It will import versioned configuration from the config/versioned folder.

Visit yoursite.com/admin/config/development/configuration/full/import to update your production site.

Update local project with production data & settings

./scripts/update_local_from_prod

It will update the database, rsync the files and configuration.

Todo

See TODO.md.