Craft Boilerplate
Switch branches/tags
Nothing to show
Clone or download
Latest commit 597cb3e Oct 11, 2018

README.md

Marbles     Craft CMS

About marbles/craft

This is an alternate scaffolding package for Craft 3 CMS projects to Pixel & Tonic's canonical craftcms/craft package based on nystudio107/craft.

In addition to setting up a new Craft 3 CMS project, this project sets up:

...and sets up some other base scaffolding as described to the following articles:

It also installs a few base plugins that we use on every project.

Assumptions Made

Since this is boilerplate that Marbles uses for projects, it is by definition opinionated, and has a number of assumptions:

  • Laravel Mix is used as a the frontend workflow automation tool
  • Vue is used as the frontend JavaScript framework, with Axios providing the http client
  • Tailwind CSS is used as the utility-first CSS framework
  • Critical CSS is used site-wide
  • FontFaceObserver is used for font loading
  • Craft-Scripts are used for db/asset synching
  • Craft 3 Multi-Environment is used for the Craft 3 multi-environment setup

Obviously you're free to remove whatever components you don't need/want to use.

Using marbles/craft

This project package works exactly the way Pixel & Tonic's craftcms/craft package works; you create a new project by first creating & installing the project:

composer create-project marbles/craft PATH

Make sure that PATH is the path to your project, including the name you want for the project, e.g.:

composer create-project marbles/craft craft3

Then cd to your new project directory, and run Craft's setup console command to create your .env environments and optionally install:

cd PATH
./craft setup

Finally, run the marbles-setup command to configure Craft-Scripts & Craft 3 Multi-Environment based on your newly created .env settings:

./marbles-setup

And last but not least:

Import the databank found in your project folder (craft.sql)

That's it, enjoy!

If you ever delete the vendor folder or such, just re-run:

./marbles-setup

...and it will re-create the symlink to your .env.sh; don't worry, it won't stomp on any changes you've made.

Below is the entire intact, unmodified README.md from Pixel & Tonic's craftcms/craft:

.....

About Craft CMS

Craft is a flexible and scalable CMS for creating bespoke digital experiences on the web and beyond.

It features:

Learn more about it at craftcms.com.

Tech Specs

Craft is written in PHP (7+), and built on the Yii 2 framework. It can connect to MySQL (5.5+) and PostgreSQL (9.5+) for content storage.

Installation

See the following documentation pages for help installing Craft 3:

Resources

Official Resources

  • Documentation – Everything from usage instructions to plugin guides.
  • Class Reference – Full API and class reference for plugin and module developers.
  • Demo site – Quickly launch a personalized demo of a Craft site.
  • Craft Slack – Join one of the most friendly and helpful Slack groups around.
  • Craft Commerce – First-party e-commerce platform for Craft.

Community Resources