Home

Awesome

Refinery CMS™

An open source content management system for Rails 5.1+

More information at https://www.refinerycms.com

Build Status Code Climate Coverage Status

You can chat with us using Gitter:

Gitter chat

You can deploy an example app to Heroku:

Deploy

Requirements

How to

Getting Started

If you're new to Refinery, start with this guide:

For Rails 5.1+ support, you can use version 4.0.x using this template:

rails new app_name -m https://www.refinerycms.com/t/4.0.0

For Rails 4.2.x support, you can use version 3.0.x using this template:

rails new app_name -m https://www.refinerycms.com/t/3.0.6

You can also install the edge version for the latest code using this template:

rails new app_name -m https://www.refinerycms.com/t/edge

What's it good at?

Refinery is great for sites where the client needs to be able to update their website themselves without being bombarded with anything too complicated.

Unlike other content managers, Refinery is truly aimed at the end user making it easy for them to pick up and make changes themselves.

For developers

Help and Documentation

Features

Pages

Images & Files

Authentication & Users

Custom Extensions

Extend Refinery easily by running the Refinery extension generator. For help run the command without any options:

rails generate refinery:engine

Popular Extensions

Full extension list here

Example Site Showcase

List here (add your link when you're done)

Contributing

See contributing.md and Contributing to Refinery guide for details about contributing and running test.

License

Refinery CMS™ is released under the MIT license. See the license.md file for details.

Credits

Many of the icons used in Refinery CMS™ are from the wonderful Silk library by Mark James.