21 Dec 2009
Starting a Rails 3 app from scratch
There's not much in the way of documentation on using Rails 3 at the moment, so I thought I'd collect my notes from getting a new app up and running so other people could use them as well.
First thing you need is the bundler gem, to save you from gem dependency hell (hurrah):
gem install bundler
A new Rails app
Then you need an app. Assuming that your app is named "myapp" (which is a pretty bad assumption), here's what you might do:
mkdir myapp cd myapp curl -o Gemfile http://andre.arko.net/2009/12/21/starting-a-rails-3-app-from-scratch/Gemfile.example gem bundle
That creates a new directory for your app, pulls down a (sort of) minimal Gemfile, and then tells the bundler to bundle up Rails and all its dependencies for you to use in this app.
Then you'll want to use the copy of Rails that you just bundled to generate the default app structure, like so:
When it asks you if you want to overwrite the Gemfile, you know what to do: just say
After you're done, I suggest running
./script/about to make sure that all the bundling went well and Rails can load and all that good stuff. Assuming it works, you have yourself a new Rails 3 app! And without installing any system gems. How about that.
Gems and generators and ooh shiny
At this point, you are pretty much set, and can run off and make your app do whatever it is that your heart desires. However, there are some more cool edgy things available, should you be interested. My current set of goodies includes Rack::Bug, Thor, RSpec, DataMapper, respondto scaffolds. Most of these goodies were inspired (or just copied) from github.com/josevalim/thirdrails.
To get their gems installed, uncomment the lines in the Gemfile and the run
gem bundleagain to install them all.
Export the generators into
git clone git://github.com/indirect/rails3-generators.git lib/generators rm -rf lib/generators/.git
To enable the generators, put these lines into your
config.generators do |g| g.scaffold_controller :responders_controller g.orm :datamapper g.template_engine :erb, :layout => true g.test_framework :rspec, :fixtures => true, :integration_tool => false, :routes => true, :views => false g.integration_tool :rspec end
Switching to RSpec is then pretty easy:
./script/generate rspec:install rm -rf test
Thor needs a Thorfile, and can replace the Rakefile that Rails included with your app.
curl -o Thorfile http://andre.arko.net/2009/12/21/starting-a-rails-3-app-from-scratch/Thorfile.example rm Rakefile thor -T
Rack::Bug is just a plugin, so it's pretty easy.
script/plugin install git://github.com/brynary/rack-bug.git
config/development.rb, add this line:
Because ActionView#render_templates has been removed, I had to comment out the TemplatesPanel in
rack/bug/options.rb:80for rack-bug to work. I imagine the bug will be fixed relatively quickly, though.
Git it done already
This is probably a good time to start tracking your app in source control:
git init curl -o .gitignore http://andre.arko.net/2009/12/21/starting-a-rails-3-app-from-scratch/gitignore.example git add . git commit -m "New Rails 3 app with bundled gems"
TextMate with Rspec Bundle
Lastly, if you want to use RSpec from TextMate in the manner to which you have (likely) become accustomed, you will need to install a new version of RSpec.tmbundle that has support for libraries installed via the bundler.
cd ~/Library/Application\ Support/TextMate/Bundles/ git clone git://github.com/indirect/rspec-tmbundle.git RSpec.tmbundle osascript -e 'tell app "TextMate" to reload bundles'
If you've actually made it all the way here, I'm terribly impressed. If for some reason you want to follow along with these steps, you can check out my blank Rails 3 app repository at Github. Have fun with Rails 3!