MIDDLEMAN Starter Kit

Middleman starter kit with custom basic features for ruby/html/css/js webdesign

see a basic-grid demo

Features

• Sass ready with Bourbon / Neat / Bitters
• A basic layout page & index page based on Normalize
• Livereload for development mode and Minify css/js for prod
• Jquery 2 (not for ie 6/7/8) or Jquery 1
• Google Fonts with Open-sans
• Heroku ready with puma
• ERB by default
• FontAwesome 4.3.0
• Google Analytics

System requirements

• Heroku Toolbelt and a heroku account.
• Ruby (you can set your own version in the Gemfile)(2.1.2 by default)

Installation

Setup

mkdir your-folder
git clone git@github.com:magiknono/middleman-heroku-bourbon-ready.git your-folder
cd your-folder
git remote rm origin
git remote add origin your-git-url

Install gems

bundle install

current version is : Middleman 3.3.12 and all gems are fixed in Gemfile

##Start middleman

middleman server

test in your browser : http://localhost:4567 ##Deploy to heroku First Commit

git init
git add .
git commit -m "initialise custom middleman starter kit"

Deploy to heroku and test in browser

heroku create
heroku push origin master
heroku open

How to start

see the demo at http://localhost:4567

set your own ruby version in Gemfile
override the grid to make your own in source/stylesheet/base/_grid_settings.scss
write your html index in source/index.html.erb and create new pages
write your own css in source/stylesheets/_custom.scss
customize your own scss variables in source/stylesheets/base/_variables.scss
write your own js in source/javascripts/_lib.js
replace the jquery you want in source/javascripts/all.js
your content can be in data/your-file.yml 
Add your google analytics is in config.rb

Enjoy!

BUG

• google fonts are only loaded in http, blocked in https
• you need some more tweakings for ie, it's not made for ie6/7/8

Link for more info

• start here : https://middlemanapp.com/
• read the doc of neat and bourbon

TO DO

• make one demo site with erb and maybe after migrating to slim
• create a command line for configuration option
• gem sitemap or manual set ?
• add generate number for img ?
• activate pretty url

License

Copyright (c) 2015 Arnaud Cormier. MIT Licensed, see LICENSE for details.