Skip to content
Craig Riecke edited this page Aug 1, 2014 · 44 revisions

For version 4.0 (currently in beta), see [V4.0] Home

BrowserCMS is a general purpose, open source Web Content Management System (CMS), written in Ruby on Rails. It is designed to support three distinct groups of people:

  1. Non-technical web editors who want a humane system to manage their site, without needing to understand what HTML or even Rails is.
  2. Designers who want to create large and elegantly designed websites with no artificial constraints by the CMS.
  3. Developers who want create CMS driven websites for their clients, or add a CMS to their Rails applications.
  • There is another sequence of reading these documents, as given by the numbers in parenthesis.

Documentation / Guides

  1. Getting Started – (1) Installing BrowserCMS and creating your first project.
  2. User's Manual – (5) How site builders can use the user interface to create sites.
  3. Upgrading a BrowserCMS Project – (2) How to upgrade a project or module to a newer version.
  4. Deployment Guide – How to configure your production server (using Apache/Passenger)
  5. Articles – A list of articles contributed by the Community on how to use, customize and extend BrowserCMS.
  6. API DocsYARD API documents for the latest version of the project.
  7. Proposals – A landing page for proposals that would be significant changes or improvements to either the Core CMS or modules.
  8. Adding BrowserCMS to an Existing Rails project – A guide to ‘CMSifying’ your existing Rails appliciation
  9. Setting up Mobile Sites – A guide to configuring BrowserCMS to serve mobile content. (Coming in v3.5, see bcms_mobile until then.)

Extending BrowserCMS

  1. Content Blocks – (6) How to defining new content types for your site.
  2. Portlets – (7) How to fetch and dynamically display content
  3. Templates – (3) How to create a theme/design for a site.
  4. Building BrowserCMS from Edge – How to work with the very latest version of BrowserCMS from github
  5. Controllers with Authentication – How to create ActionControllers which use CMS authentication
  6. Working with the Content API – Understanding a few of the ‘gotchas’ between ActiveRecord and Content Blocks.


  1. Module List – Find other modules to add to your BrowserCMS project.
  2. Installing a Module – (4) How to add new functionality (modules) to your project
  3. Building Modules – Creating your own modules to share with the community.

Reference guides for older versions (BrowserCMS 3.1) are still available.

Code Tips / Snippets

Check out our page with some handy tips and snippets

Contributing to the Project


If you have questions, you can also find us in a few places:

  1. Our google group/mailing list
  2. On Twitter at @browsercms
  3. In IRC, at, channel #browsercms
Clone this wiki locally
You can’t perform that action at this time.