The Singlebrook Drupal Bootstrap is a starting point for new Drupal projects. Highlights include:
- A base structure ready for deployment to Acquia
- Some handy bash scripts for project initialization, rebuilding and seamless integration with theming tools like Sass and LiveReload
- A ready-to-go profile and theme with standard project conveniences
- A custom Dev module that wraps useful dev tools like devel, diff and field_ui
You can read more about the bash scripts in the readme of the bin
folder. Typical setup is as follows:
- Download the zipped version of the project
- Configure your vhost, if necessary
- Create your db
- Create a
sites/default/settings.php
file or run installer up to the "Configure site" pane. - Run
$ bin/init
from the project root and answer questions
Your responses to the questions in the init script will set up the site for the new client and replace a bunch of placholder variables in the profile and theme. It will also rename this readme and create a new, blank readme and initialize the new git repo, before running a drush site-install. The Drupal username post-install is 'admin' and the password is 'testing'.
This project is configured with guard to watch for changes to the scss and js files and compile them. There is a an executable script in the bin folder which starts both the guardfile and the livereload server.
- Ruby
- Bundler
- run
$ bundle install
once from the project root to download guard and livereload utilities
To start theming, run $ bin/themify
from the project root and edited Sass and js files will automagically reload in the browser. To stop the guard and livereload processes, hit ^c
(control + c).
It is not advised to run the init script if you're updating the bootstrap itself. Instead, run the project with the sb_client profile and sb_template theme. Themify will work out of the box, and simplify updates to the bootstrap.