== RailApp: ruby on rails application starter

RailApp is a base application for Ruby On Rails web development.

- Download RailApp on GitHub
- Free and Open Source
- Built on Ruby On Rails 2.2, Rspec
- Easy to add user authentication - we recommend the authlogic plugin and tutorial because authlogic is a major improvement over the old restful_authentication generator


== What does it download?

RailApp downloads these gems if you need them:

    rubygems-update
    RubyGems is a package manager for distributing Ruby programs and libraries called gems.
    http://www.rubygems.org/
    >=1.3.1

    rake
    Rake is a simple ruby build program with capabilities similar to make.
    http://rake.rubyforge.org/
    >=0.8.3

    rails
    ruby on rails
    http://rubyonrails.com/
    >=2.1.2

    rspec
    RSpec is a Behaviour Driven Development framework for Ruby.
    http://rspec.info/
    >=1.1.11

    rspec-rails
    RSpec is a Behaviour Driven Development framework for Ruby.
    http://rspec.info/
    >=1.1.11

    treetop
    Treetop is a language tool that parses expression grammars to help you analyze syntax.
    http://treetop.rubyforge.org/
    >=1.2.4

    aslakhellesoy-cucumber
    Cucumber is a testing tool that can execute feature documentation written in plain text.
    http://github.com/aslakhellesoy/cucumber/wikis
    >=0.1.10

    hpricot
    Hpricot is a very flexible HTML parser,
    http://code.whytheluckystiff.net/hpricot/
    >=0.6.164

    cheat
    Cheat is a simple command line utility reference program.
    http://cheat.errtheblog.com/
    >=0.0.0

    zentest
    ZenTest bundles tools for unit tests, diff, autotest, multiruby, Test:::Rails.
    http://www.freshports.org/devel/rubygem-zentest/
    >=3.11.0

    hoe
    Hoe is a simple rake/rubygems helper that generates all the usual tasks for projects.
    http://seattlerb.rubyforge.org/hoe/
    >=1.8.2

    authlogic
    AuthLogic is a clean rails restful authentication solution with a gem instead of a generator.
    http://authlogic.rubyforge.org/
    >=1.3.4

    polyglot
    Polyglot provides a registry of file types and custom file loaders to require and process files.
    http://polyglot.rubyforge.org/
    >=0.2.3

    rack
    Rack provides an minimal interface between webservers supporting Ruby and Ruby frameworks.
    http://rack.rubyforge.org/
    >=0.4.0

    json
    JSON implementation for Ruby, using fast compiled bindings.
    http://json.rubyforge.org/
    >=1.1.3

    json_pure
    JSON implementation for Rub,y using pure ruby processing.
    http://json.rubyforge.org/
    >=1.1.3

    mocha
    Mocha is a test library to mock and stub using a syntax that works with many test frameworks.
    http://www.workingwithrails.com/rubygem/4606-mocha
    >=0.9.2

    mime-types
    MIME Types manages a MIME Content-Type that will return the Content-Type for a given filename.
    http://mime-types.rubyforge.org/
    >=1.15.0

    highline
    HighLine improves console input/output with error checking, validations, and typecasting.
    http://highline.rubyforge.org/
    >=1.5.0

    rubyinline
    RubyInline enables you to embed code in C, C++, and other languages into your ruby script..
    http://www.zenspider.com/ZSS/Products/RubyInline/
    >=3.8.1

    RedCloth
    RedCloth is a module for using Textile in Ruby, a simple text format for creating HTML.
    http://whytheluckystiff.net/ruby/redcloth/
    >=4.1.1

    Selenium
    Selenium-Ruby bundles the selenium server and Ruby classes in a gem.
    http://selenium.rubyforge.org/getting-started.html
    >=1.1.14

    haml
    Haml helps generating views in your Rails application by improving ERB and HTML
    http://haml.hamptoncatlin.com/
    >=2.0.4


== What does it include?

- Many typical models: users, roles, cities, countries, invoices, goals, etc.
- Userstamp plug-in which extends ActiveRecord to add automatic updating of 'creator' and 'updater' attributes.
- A new app/presenter directory for presenters that work with your controllers and views-- see Martin Fowler's Presentation Model
- Seed data for countries and provinces


== Database

Many typical ruby on rails applications are read often, write rarely. To help this, we index many database fields to increase read speed and efficiency:

- fields for joins, such as foreign keys
- fields for sorting, such as dates and times
- fields for calculations, such as latitude and longitude
- fields for autocompletions, such as user names and keywords


== ISO Standards

Countries use the ISO 3166-2 international standard. For example the United States is "US" and Cananda is "CA". Country subdivisions such as states, provinces, and territories all use ISO 3166 codes. For example, California is "US-CA" and Ontario is "CA-ON".

Languages use ISO 639. For example "en" means "English" and "fr" means "French"

== Seed Data

Seed data is in /lib/tasks/db_seed_*.rake To seed, run these rake tasks:

- rake db:seed:countries
- rake db:seed:provinces