!http://clients.fudgestudios.com/chester.jpg!

h1. Bort

Bort is a base Rails application that makes creating new projects easier and faster. Bort is developed and maintained by "Fudge Studios":http://www.fudgestudios.com, "Jim Neath":http://jimneath.org and "Matt Hall":http://matthall.wordpress.com

This Rails 2.3 fork is by "Jay McGavren":http://jay.mcgavren.com

h2. Install

• Download and unzip Bort
• Edit the database.yml and the settings.yml files
• Change the default password in the bort migration
• Edit the REST_AUTH_SITE_KEY in each of the environment files
• Rake db:migrate
• Have a brew and celebrate

h2. Plugins Installed

This fork of Bort has had some of its default plugins dropped, new ones added, and most of the rest updated.

h3. Authlogic

RESTful Authentication has been replaced with Authlogic. A few controllers are already set up as in the Authlogic examples.

h3. User Roles

Bort now comes with "Role Requirement":http://code.google.com/p/rolerequirement/ by Tim Harper. A default admin role is predefined along with a default admin user. See the migrations for the admin login details.

h3. Open ID Authentication

Bort, as of 0.3, has Open ID. Rejoice!

h3. Will Paginate

We use will_paginate in pretty much every project we use, so Bort comes with it pre-installed.

h3. Rspec & Rspec-rails

You should be testing your code, so Bort comes with Rspec and Rspec-rails already installed so you're ready to roll.

h3. Cucumber

You should also be integration testing your code. Cucumber has been added.

h3. Factory Girl

Factories make object creation for use in specs less painful and more versatile.

h3. Exception Notifier

You don't want your applications to crash and burn so Exception Notifier is already installed to let you know when everything goes to shit.

h3. Asset Packager

Packages up your css/javascript so you're not sending 143 files down to the user at the same time. Reduces load times and saves you bandwidth.

h2. Routes

The routes for Authlogic are already sorted for you.

h2. Settings YAML

There is a settings.yml file that contains site-wide stuff. The site name, url and admin email are all used in the RESTful Auth mailers, so you don't need to worry about editing them.

h2. Database YAML

The database.yml defaults to sqlite3 but also contains the settings for MySQL in comments so you can switch over easily.

h2. Capistrano Recipe

Bort comes ready to rock capistrano. The recipe that is setup is based on using git and passenger. It's ready to go with multistage deployments. It deploys to the production config by default, so if you don't need it you can ignore it. Just update config/deploy/production.rb with your deployment settings.

More info on capistrano-ext/multistage deployments can be found here: http://weblog.jamisbuck.org/2007/7/23/capistrano-multistage

h2. Misc

• password and password_confirmation are set up to be filtered
• there is a default application layout file
• a page title helper has been added
• index.html is already deleted
• rails.png is already deleted
• a few changes have been made to the default views
• a default css file with blank selectors for common rails elements

h2. Credits

Bort put together by people at "Fudge":http://www.fudgestudios.com/

This fork by "Jay McGavren":http://jay.mcgavren.com