Handcrafted's Foundation Application, a clean starting point for every app

License: MIT

Language: JavaScript

Handcrafted Foundation

Handcrafted is a small team of Ruby on Rails developers (mainly Josh Owens and Adam Stacoviak). We focus on creating smart, usable web sites built on a foundation of clean, extensible, handcrafted code. We eat our own dog food, we use Foundation as our core starting point to ensure consistency through-out our applications. We bake all our goodness in here. Once.

Foundation is built with certain specific standards and opinions in mind. We were tired of re-writing and copy & pasting the same code over and over from project to project. Then git came along. Git helped us realize there was a better way.

Key Concepts

  • Make the app extensible by offering smart hooks for engines and plugins to add functionality
  • Keep the code clean. Break repeating code out into partials and re-use as needed
  • Write semantic HTML/Haml. Of course clean, organized CSS/Sass goes with that. And with the help of Compass, we get to ensure that we keep our CSS/Sass DRY
  • Tests, tests, tests. If you aren’t testing. You are wrong.

Opinionated Choices


  • We try to use “Markers” in key files, such as routes and application.js. We do this to ensure that continued foundation development doesn’t trample continued application development
  • Don’t annotate the base Foundation application. You should only be annotating the models in your real application

Installation Steps (development)

1. mkdir My-Foundation-App
2. cd My-Foundation-App
3. git init
4. git remote add foundation git://github.com/handcrafted/foundation.git
5. git pull foundation master
6. git remote add origin git@github.com:me/my-foundation-app.git
7. cp config/database.example.yml config/database.yml
8. Confirm database setup in config/database.yml
9. sudo gem sources -a http://gemcutter.org/
10. sudo gem install chronic
11. rake gems:install
12. rake db:create
13. rake db:migrate
14. rake db:seed
15. compass


See LICENSE file

Project Statistics

Sourcerank 4
Repository Size 3.74 MB
Stars 26
Forks 11
Watchers 5
Open issues 0
Dependencies 0
Contributors 3
Tags 1
Last updated
Last pushed

Top Contributors See all

Josh Owens Michael Christenson II Chris Saylor

Recent Tags See all

v1.0.0 December 05, 2009

Interesting Forks See all

FourBeanSoup's Broth Application, a tasty starting point for every app
JavaScript - MIT - Last pushed - 12 stars - 5 forks
Handcrafted's Foundation Application, a clean starting point for every app
JavaScript - Last pushed - 2 stars - 1 forks

Something wrong with this page? Make a suggestion

Last synced: 2017-11-24 19:38:41 UTC

Login to resync this repository