fusionary/craftcms-boilerplate

Craft CMS Boilerplate

dev-redacted 2018-03-23 10:56 UTC

Requires

• php: >=7.1.0
• charliedev/element-map: ^1.0
• clubstudioltd/craft-asset-rev: ^6.0
• craftcms/aws-s3: ^1.0
• craftcms/cms: ^3.0.0-RC14
• craftcms/mailgun: ^1.2
• craftcms/redactor: ^1.0
• fusionary/craftcms-bootstrap: ^1.14.0
• mmikkel/cp-field-inspect: ^1.0

MIT

• cms
• project
• Craft
• craftcms

README

Opinionated boilerplate configuration of Craft CMS.

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

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

1. Grab the lastest DevOps goodies

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

1. Ansible Vault Password

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

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

1. Provision and Build Environment

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

1. Get a Database

yarn db pull development

1. Start Developing

Enjoy hot-module replacement/css live-reloading.

yarn start

More Info

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