This is a fork from BaseApp in attempt to make it a more suitable backoffice and structure for my own projects but it might have something you like.
JavaScript Ruby
Pull request Compare This branch is 88 commits ahead of mattistrading:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Welcome to BaseApp-Orange v4


Este é um fork do projecto BaseApp na tentativa de o tornar mais adequado à maioria dos nossos projectos e servir de uma base de trabalho sólida e rápida de implementar.
Em vez de repetir o mesmo trabalho, porque não criar uma base?

Mais info em


  • username: admin
  • pass: ‘yippeekayea’

Update V4

  • Removido muito código
  • Código comum a controllers no admin foi posto em app/controllers/admin_controller.rb, os outros herdam deste.
  • Código comum a models foi posto em lib/common_oranges_for_models.rb
  • Integração do CKEditor com Paperclip
  • Integração com o translatable_columns para gerir campos dos models em pt/en
  • Melhor uso do inherited_resources
  • Galeria de Imagens removida
  • Adicionei últimas traduções para rails 2.3.4 no ficheiro config/locales/pt.yml
  • Adicionada uma tab no admin para Temas, de forma a associar uma página a um controller. ex: /news irá tratar da apresentação das notícias.
  • Melhorado o generator do backoffice, para usar:
    • cria o model: script/generate model Topic title_en:string title_nl:string title_de:string title_fr:string
    • corre a migração: rake db:migrate
    • adiciona o caminho á route: admin.resources :topics
    • usa o generator: script/generate adminator topic


  • Suporte total i18n (backoffice e frontend)
  • Incluir Testes com RSPEC para os models
  • Ler configuração para o menu do backoffice de um fich yml ou bd
  • Form generator no backoffice
  • Integração com google analytics
  • Passar todo o código para um Template Rails
  • Mais generators
    • para relações one to many e many to many
    • para diferentes tipos (com ordenação, por exemplo)

Principais diferenças do BaseApp Original:

  • Plugins íncluidos
    • Jrails para suporte JQuery (remover se preferir Prototype)
    • CKEditor para editar páginas com html
    • Will Paginate
    • Paperclip para upload de ficheiros
    • RSPEC para testes
    • OpenID
    • Permalink_fu para criar links bonitos (SEO)
    • Bundle_fu para comprimir ficheiros javascript e css num só.
    • Inherited_resources para reduzir código em controllers REST
    • Generator adminator para facilitar a criação de páginas no admin

Before you start. This is a fork from BaseApp in attempt to make it a more suitable backoffice and structure for my own projects but it might have something you like, so why not contribute?

More info at

Update V4

  • Cleaned up code
  • Common controller code lives in app/controllers/admin_controller.rb
  • Common model code lives in lib/common_oranges_for_models.rb
  • Integrated with CKEditor and Paperclip
  • Integrated with translatable_columns
  • Better use of inherited_resources
  • Added themes, a quick way to associate a page with a given controller, ex: /news handles news
  • Improved adminator generator:
    • create a model: script/generate model Topic title_en:string title_nl:string title_de:string title_fr:string
    • run the migration: rake db:migrate
    • add the route: admin.resources :topics
    • run the generator: script/generate adminator topic

Main diferences from BaseApp:

  • Pages, sub-pages and expand/colapse rows in the admin
  • News
  • Multi-Language (not yet fully implemented)
  • Snippets
  • Fields for meta description, keywords, and permalink
  • Fully translated to portuguese (also included i18n locale)
  • Pretty admin theme (with diagona and famfamfam icons)
  • Other plugins included
    • Jrails for (jQuery support)
    • Bundle-fu instead of asset_packager
    • FckEditor to edit pages with image file upload support
    • WillPaginate Gem
    • Paperclip for uploading files
    • Permalink-fu for generating erm, permalinks? (SEO)
    • Acts as taggable
    • RSPEC
    • OpenID authentication
    • Bundle_fu to compress several js and css files into one
    • Inherited_resources to reduce code in REST controllers
    • Admin generator to create admin pages and code
  • TODO *
  • Full i18n support with multi-languages for frontend && backoffice
  • Frontend implementation of pages, snippets and languages
  • Add Rspec TESTS for all models and admin controllers

This is a early build.

What is BaseAPP

BaseApp is a default Ruby on Rails project that kick-starts your next Rails project.
Read the next paragraph for a quickstart. Head over to for more detailed documentation or to report bugs and request features.


Ok, before you dive in :-)

These 6 simple steps are the essentials to get you smoothly up and running…

  1. Create your own config/database.yml (you can copy one of the sample files in there and edit it)
  2. Edit the config/config.yml file to suit your needs
  3. Open a shell and run rake db:migrate to create your database and setup the prepared defaults.
  4. Start your server with ./script/server
  5. Open up http://localhost:3000 and login with username ‘admin’ and password ‘yippeekayea’.

Configatron vs. Settings

Previously, site settings were stored in the database. Now, you have two options for storing configuration settings.

1. Configatron config/config.yml

All default configuration options that are not ‘user changeable’ should go in config/config.yml. This uses the Configatron gem (frozen in vendor/gems).

To retrieve the site name you may use ‘configatron.site_name’ everywhere in your code.

2. Settings in database

It’s still possible to store user changeable settings in the database model Setting.

Note: As long as there are no Settings in the database, the ‘Settings’ tab for the administrator is hidden. Once you add a Setting to the database through a migration (or otherwise), the Settings tab will show up.


  • Layout
    • Tabs
    • Global links
    • Optional sidebar
    • Notice, warning and error flash messages
    • Both a default stylesheet as well as a ‘clean’ one are included for easy layout development.
  • Default dashboard page
  • Administration panel where you can:
    • Manage users (add, delete, purge, suspend, activate, send new passwords)
    • Manage settings
  • User authentication, with password recovery and login recovery and account activation (by email)
  • User Profiles:
    • Location, Website, Full name fields by default, easily extendible.
    • Gravatar for avatar support
  • Very useful Rails plugin available:
    • restful_authentication
    • acts_as_state_machine
    • asset_packager
  • Multi-stage deployments according to the D-TAP system (Development, Testing, Acceptance, Production). If you don’t want to use, production is the default deployment option. more info

Features, bugs and development!

BaseApp is open source software and relies on your contributions to grow! We have some useful utilities that may help you out.

The BaseApp website provides you with up-to-date development information and the latest news regarding BaseApp.

GitHub always contains the latest BaseApp code. Fork your own development branch here if you wish to contribute code.

Pull requests should be send to ‘ariejan’ to include them in the main BaseApp code base.

Bug reports and feature requests should be posted in LightHouse.

Bugs always have priority over new features! But, you’re free to help out with whatever you want.


BaseAPP is developed by Kabisa ICT, Ariejan de Vroom and a whole bunch of cool contributors.

BaseApp is released to the public under the MIT license.