Source of AlchemyCMS guidelines
Fetching latest commit…
Cannot retrieve the latest commit at this time.

The Alchemy CMS Guidelines

The master branch covers the Alchemy CMS edge version.

Please check out the other branches for guides for the latest stable or older versions of Alchemy CMS.

The guides are created with the guides gem and are written in textile markup.

File locations

The top level namespace includes the top level static welcome page of

The actual guides live in the /guides folder.

Preview the guides

In the /guides folder:


bundle install

to install guides.

To run a local guides server, run

bundle exec guides preview

The server will be available at


Build the guides html files with:

bundle exec guides build --clean

If you are building the master branch, please use the --edge flag


Deploy the files via:

bundle exec cap deploy

Deployment takes care of the version deployed. So, if you want to deploy the 3.3 guides you need to checkout the 3.3 branch first.

The master branch deploys the edge version.


  1. Fork it
  2. Create a branch (git checkout -b my-new-guide)
  3. Commit your changes (git commit -am 'Add new guide for elements')
  4. Push to the branch (git push origin my-new-guide)
  5. Create new Pull Request