foundation-boilerplate

If you want support, please use foundation forum with the foundation-boilerplate tag and not the GitHub issues tracker. Only post an issue here if you think you discovered a bug or have a feature request.

About

foundation-boilerplate is a collection of useful starter kits to help you prototype with foundation framework faster. This application is lovely handcrafted with the help of Middleman and includes my favorite front-end tools.

About Middleman

Middleman is a static site generator built in Ruby. This makes it a great fit for projects that may end up as a Ruby on Rails app. Its minimalistic structure makes it very easy to work with, and includes support for deploying to Github Pages.

Preprocessing

• Slim [for html]
• Sass [for css]
• CoffeeScript [for js]

Tools

• Bower [js package management]
• Foundation [sass helpers/mixins]
• Middleman Live Reload [Reloads the page when files change]
• GitHub Pages [deployment/hosting]

Getting Started

Set up your project in your code directory

git clone [email protected]:flexbox/foundation-boilerplate.git your-project-folder
cd your-project-folder
git remote rm origin
git remote add origin your-git-url

Install dependencies

bundle install
bower install

Launch the server on your machine

middleman server

Deploy to Github Pages

middleman deploy

Architecture

Stylesheets, fonts, images, and JavaScript files go in the /source/assets/ directory. Vendor stylesheets and JavaScripts should go in each of their /bower_components/ directories.

boilerplate/
├── bower_components/
│    └── ...
├── source/
│   ├── assets/
│   └── ...

Demo

→ http://flexbox.github.io/foundation-boilerplate/

Contributing

If you have problems, please create a GitHub Issue.

Have a fix or want to add a feature? Pull Requests are welcome!

Author

David Leuliette

License

This project is free software, and may be redistributed under GNU/GPL license.