Welcome to BaseApp
BaseApp is a default Ruby on Rails project that kick-starts your next Rails project.
Ok, before you dive in :-)
These 6 simple steps are the essentials to get you smoothly up and running…
- Create your own config/database.yml (you can copy one of the sample files in there and edit it)
- Edit the config/config.yml file to suit your needs
- Open a shell and run
rake db:migrateto create your database and setup the prepared defaults.
- Start your server with
- Open up http://localhost:3000 and login with username ‘admin’ and password ‘baseapp’.
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.
- 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:
- 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 released to the public under the MIT license.