gyndav / happyplan

A static file generator using jekyll, compass, fontcustom and grunt.

Home Page:mdwn.in/gh/happyplan/happyplan

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

HappyPlan!

Code Climate Build Status Dependency Status NPM version

A fantastic preconfigured static website generator, based on Grunt.js

HappyPlan is a static website generator based on a bundle of amazing tools. It's just all about fun.

What in it ?

  • A task-based command line build tool: Grunt.js & all pre-defined tasks you'll need (scripts, styles & images automatic minification & compression).
  • A static website generator from html or markdown: assemble.
  • An amazing CSS pre-processor, Sass (via libsass).
  • Autoprefixer to automatically add CSS vendor prefix to your CSS, using to caniuse.com database.
  • A quick way to provide scalable icons as font thanks an awesome Grunt task grunt-webfont.
  • A Livereload server provided by the grunt-contrib-watch task to make development as fast as hell.
  • Support the Bower package manager to handle web components.

Notice: you can change/override/add stuff very easily, thanks to grunt. More about that in the documentation

Oh, by the way, why "happy plan" ? Here is not the answer.

Documentation

Visit the documentation for all the things.

TL;DR

Requirements

According you already have Node & NPM installed you can run this commands:

npm install -g grunt-cli happyplan-cli bower

Learn more about requirements.

Create a project using happyplan

Copy our Gemfile or create one with version you want, then

npm init
npm install happyplan --save-dev
happyplan

Contributing

When you want to fix a bug or add a feature, just be sure to get all testing requirements installed, & run tests before making your Pull Request.

You can run in one command the build process & the tests.

npm install
npm test

In case you don't know it yet, npm {cmd} just run the command {cmd} specified in the package.json script section. In our case, it run grunt test. And to be precise, the test task run the nodeunit one.

Release History

Checkout CHANGELOG.

Support

IRC

Come up and say hello on IRC! We'll be glad to answer you if you have any questions.

#happyplan on irc.freenode.net

Twitter

Follow us on Twitter to get latest news: @happyplanapp.

Credits

Thank you Catherine Please for your excellent logo.

Authors

Bitdeli Badge

About

A static file generator using jekyll, compass, fontcustom and grunt.

mdwn.in/gh/happyplan/happyplan

License:MIT License


Languages

Language:JavaScript 99.1%Language:CSS 0.9%