A devcontainer based local Backdrop CMS dev environment
Some of the values of this project:
- Create an identical environment on any workstation
- Require as few tools and custom scripts as possible
- Be as explicit as possible in all requirements
- Encourage config as code to prevent drift
- Cattle not pets
- Reproduce a production site quickly and automatically
This repository is designed to be used with Visual Studio Code and requires a container management and virtualization solution such as Docker Desktop.
For more information on setting up your local environment see this tutorial:
https://code.visualstudio.com/docs/devcontainers/tutorial
-
Prepare your workstation using this tutorial
-
Clone this repository:
git clone https://github.com/ronan/backdev
-
Open it in VS Code:
code backdev
-
Build and Run the Dev Container
VS Code you should prompt you to reopen the repository in a dev container. Or you can run the
Rebuild and Run in Container
command from the command palette. -
Visit http://localhost in your browser.
Debugging works as it's supposed to. Just hit f5 and set some breakpoints.
There are some defined VS Code tasks. Run "Tasks: Run Task" and choose from the list.
Drops and creates the backdrop
database and deletes the active config file so that the installer can be run again.
- Add more Backdrop/Drupal-specific dev tooling, linting, log viewers, sql tools etc.
- Add opinionated container config for redis and solr.
- Github Codespaces support.
- Automatic production data sync with PII masking.
- Auto-refreshing web previews and builds for theme development.
This project is very early in development and structure can and will change. If you want to use this version you should fork or copy it because upstream merges won't be a priority until it is more stable and feature rich.