This project is based upon HTML5 Boilerplate and adds more structure for SCSS and JavaScript files, includes build tasks and a whole lot more.
Dependencies
You will need to install some stuff, if you haven't already:
Majors:
- Node.js
Secondaries:
- Node: npm
- Bower
After you've set this stuff up please run
$ npm install -g grunt-cli
This installs the Grunt command line tools. Afterwards please run
$ npm install
in your project's directory.
This will install all the things you need for running the grunt-tasks
automatically and all Bower components defined in bower.json
.
Also it will create a folder components
which holds all vendor dependencies
managed by Bower.
Troubleshooting
If running the install does not work, please try running it as with admin-rights:
$ sudo npm install -g grunt-cli
Browser support
- Chrome
- Firefox 4+
- Internet Explorer 8+
- Opera 12+
- Safari 5+
Yeoman Generator-INIT
INIT is also available as Yeoman Generator and is called generator-init
. See the repository for detailed instruction and more information.
Contribute
Please help making this project better and contribute with your knowledge.
CSS
We currently work with Sass (in its dialect SCSS) and do not use CSS directly. We use libsass which is a C implementation of Ruby Sass, thus faster.
Please do not edit the CSS-files in any case but search the corresponding .scss
file and edit it accordingly. If you are not familiar with SCSS you can write pure CSS which is actually valid SCSS.
However all .scss
-files are compiled into one file called main.css
in the css
-folder. There is a productive-version (means minified), too.
You can find more information about the installation process of Sass and the usage of SCSS in the Sass Tutorial.
JS
We use jQuery, Modernizr (custom build via Grunt) and RequireJS.
Please use JSHint for your JavaScript before you commit. You can use the Grunt-task jshint
for this. It is also integrated in grunt watch
.
Creating a Build
Please use Grunt.js for building a production-state of a website. The Gruntfile.js
has tasks for concatenating and minifing CSS and JavaScript.
Additional information on this project is stored in package.json
.
Development
This package is developed and maintained by Hans Christian Reinl, Anselm Hannemann and more contributors.
Credits
The INIT logo was designed by Jan von Beckerath at NIMIUS and optimized by Stefan Nitzsche.
License
Please be aware of the licenses of each component we use in this project. Everything else that has been developed by the contributions to this project is under MIT License.