An open source content management system for Rails 5.1+
More information at https://www.refinerycms.com
You can chat with us using Gitter:
You can deploy an example app to Heroku:
- ⚠️ Warning: ImageMagick currently has a serious security vulnerability, CVE-2016–3714. After installing, you must disable certain features in ImageMagick's policy configuration. Please see the following for details:
- Mac OS X users should use homebrew's
brew install imagemagickor the magick-installer.
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.
- Easily customise the look to suit the business.
- Extend with custom extensions to do anything Refinery doesn't do out of the box.
- Sticks to "the Rails way" as much as possible; we don't force you to learn new templating languages.
Help and Documentation
- Getting Started
- Google Group Discussion
- Gitter chat
- GitHub repository
- Developer/API documentation
- Twitter Account
- Easily edit and manage pages with a visual editor.
- Manage your site's structure.
Images & Files
- Easily upload and insert images.
- Upload and link to resources such as PDF documents.
- Uses the popular Dragonfly.
- Supports storage on Amazon S3.
Authentication & Users
- Manage who can access Refinery.
- Control which extensions each user has access to.
- Uses the popular Devise.
Extend Refinery easily by running the Refinery extension generator. For help run the command without any options:
rails generate refinery:engine
- Blog - A simple blogging extension that supports posts, categories and comments with optional moderation support.
- Portfolio - manage groups of images like an image gallery.
- News - post and manage news items.
- Inquiries - simple contact form that notifies you and customer when an inquiry is made.
Example Site Showcase
List here (add your link when you're done)
See contributing.md and Contributing to Refinery guide for details about contributing and running test.
Refinery CMS™ is released under the MIT license. See the license.md file for details.
Many of the icons used in Refinery CMS™ are from the wonderful Silk library by Mark James.