fusionary/craftcms-boilerplate

Craft CMS Boilerplate

Craft CMS Boilerplate

Opinionated boilerplate configuration of Craft CMS., _(*1)

Features

• Ansible/Docker environment provisioning
• CI/CD Deployments via Gitlab CI/CD
• Front-end asset building via Neutrino
• Bootstrapped and configured using Craft CMS Bootstrap

Development Quickstart

Prerequisites

• Ansible >=2.4 (brew install ansible or pip install ansible)
• Docker (brew cask install docker)

Getting Started

1. Create New Project, _(*2)

   composer create-project fusionary/craftcms-boilerplate my-project && cd my-project
   

2. Grab the lastest DevOps goodies, _(*3)

   rm -rf ops/ansible &&
   git clone https://gitlab.fusionary.com/fusionary/devops/ansible.git ops/ansible &&
   rm -rf ops/ansible/.git
   

3. Ansible Vault Password, _(*4)

   Get the Ansible Vault password for this project (probably in Keybase), and write it to ops/ansible/.vault_pass:, _(*5)

   echo "replace-me" > ops/ansible/.vault_pass
   

4. Provision and Build Environment, _(*6)

   ansible-galaxy install -r ops/ansible/requirements.yml &&
   ops/ansible/bin/provision.sh local &&
   yarn docker-compose up -d &&
   yarn docker-compose run app composer install &&
   yarn &&
   yarn build
   

5. Get a Database, _(*7)

   yarn db pull development
   

6. Start Developing, _(*8)

   Enjoy hot-module replacement/css live-reloading., _(*9)

   yarn start
   

More Info

• Full Setup Docs
• See @timkelty or @jswewart
• https://gitlab.fusionary.com/fusionary/devops/ansible