mikefrancis/craft-starter-kit

Craft CMS starter kit

Craft CMS Starter Kit

An opinionated Craft CMS starter kit, featuring the following:, _(*1)

• Sass pre-processing
• ES6 compilation
• Cache bursting
• Composer managed
• AWS S3 asset management
• Git deploys to Heroku

Installation

Start by installing Composer, if you don't already have it. Then create a new project:, _(*2)

composer create-project mikefrancis/craft-starter-kit my-new-project

Once this is complete you will then need to edit the generated .env file to add your project's URL and database and S3 credentials., _(*3)

After completing this step, the final thing to do is to run the database migrations:, _(*4)

php craft migrate

Development

You can either view your project in the browser or run the following to start a new BrowserSync server:, _(*5)

npm run watch

This will watch your source files and perform your build tasks, then reload the browser for you. The server will proxy to whatever is set as your APP_URL in your .env file., _(*6)

Deployment

When you're ready to share your project, you can deploy it to Heroku for free (at the time of writing)., _(*7)

First, create a new Heroku app and add the ClearDB add-on:, _(*8)

heroku create
heroku addons:create cleardb:ignite
heroku config:get CLEARDB_DATABASE_URL

From the CLEARDB_DATABASE_URL, you will need to extract the following:, _(*9)

mysql://{$USERNAME}:{$PASSWORD}@{$SERVER}.cleardb.net/{$DATABASE}?reconnect=true

And replace the values below with those values:, _(*10)

heroku config:set \
 APP_ENV=production \
 APP_KEY=$(openssl rand -base64 32) \
 DB_DRIVER=mysql \
 DB_HOSTNAME=SERVER.cleardb.net \
 DB_USERNAME=USERNAME \
 DB_PASSWORD=PASSWORD \
 DB_DATABASE=DATABASE

(We are trying to find a way to automate this!), _(*11)

Once these environment variables have been published to Heroku, you are ready to push your code. Heroku will then take care of installing the dependencies and migrating the database:, _(*12)

git push heroku master

Then you can view your project!, _(*13)

heroku open

Extending

As we're making use of the fantastic Laravel Mix package, you can take advantage of other configurations and build tasks enabled, such as:, _(*14)

• Copying folders (if you are using custom fonts)
• Compiling JSX templates

Please check the docs for more!, _(*15)