Kickstart is a website starter kit, living style guide creator, and task runner that helps you kickstart a website build and create a living style guide that grows with your site.
At a high level, Kickstart provides the following:
- Development and Production build tasks
- Core pattern library structure and starter files
- Living style guide generator
- Site template generator
- Command Line Interface
- Scaffold new projects or work with existing projects
- Easy templating with Handlebars and a large collection of Handlebars helpers
- Optionally create content pages using Markdown
- Sass compilation, optimization and minification
- Image optimization
- SVG spriting and optimization
- Static file serving and device synchronization with BrowserSync
The best way to start your project with Kickstart is by forking the Kickstart project into your own repo. Doing so will prevent you from having to change the repo origin URL so that you can push your changes to your own repository.
You can also install Kickstart by cloning the Kickstart repository to a local folder on your machine. After cloning the repository, you'll need to update the remote repo URL since you will not want or be able to push your changes to the source Kickstart repository.
If you clone the kickstart repo, make sure you change the remote origin URL before you attempt to push any of your customizations.
Whether you fork or clone the repository, here are the steps you need to perform the first time you bring the repo down locally:
1. git clone kickstart
git clone https://github.com/onenorth/kickstart ~/projects/my-kickstart-project
2. Start the project
npm start will install all required package dependencies, then spin up a local web server, and start watching your files for changes.
npm startwill first run
npm installso that all the required package dependencies are installed before anything else happens.
When you are only interested in building your project (e.g., compiling templates, SCSS files, etc), but do not want to start a development web server, you can simply run
npm run build to build the projects files without starting web server.
npm run build
If you want to build a minified and optimized version of your project, you can do so by passing in the
--production flag when you run
npm run build:
npm run build --production