LCM Drupal 8 Scaffolding
This is a boilerplate Drupal 8 build that bundles some standard tools to make it a good starting point for an enterprise scale Drupal build. It is conceptually similar to drupal-composer/drupal-scaffold, but it has a much simpler (and more manual) Composer setup, and includes additional tools. For additional information on this project, see the 2016 Badcamp presentation slides
Initial Project Setup
(These are only needed for creating a new project repository. Remove this section of the readme once you are done.)
- Run the following command to clone this project down. Replace PROJECTNAME with the name of the folder you want to create for the project.
composer create-project lastcall/drupal-scaffold PROJECTNAME
- Configure nvm to use the latest stable version
nvm install stable; nvm use stable;
- From the docroot:
npm install
to install nodejs dependencies. - From the docroot:
gulp install
(ornode_modules/.bin/gulp install
if you don't have gulp installed globally) to install bower and composer dependencies. - Edit the
composer.json
,package.json
, andbower.json
and rename the project as needed. - Rename the scaffold theme to match the project (including JS and SCSS files).
- Initialize a new git repository and push work to it as normal
Getting started on an already prepared project
(These will be used when working from a repo already prepared for a specific project)
- Clone the repository to your local environment
- Initalize nvm:
nvm install
- Install node packages:
npm install
- Install composer and bower packages:
gulp install
(ornode_modules/.bin/gulp install
if you don't have gulp installed globally) - Commit and push work to repository as normal
Adding Modules/Themes
You can use composer to bring in modules and themes. Just run:
composer require drupal/ctools
Contributed modules and themes are .gitignored by default, meaning you need to run gulp install
each time you clone the repository down.