Why do I need Statix in my life?
Have you ever wanted the power of reusing snippets of HTML in your templates but don’t know where to start?
Do you want a good base front-end structure for your project without throwing the whole of Bootstrap at it?
Statix can help you out.
You can use Statix in one of two ways.
You can grab Statix on , or by installing the Kickoff Yeoman Generator, which includes an option to use Statix.
Here are some of the simple problems that Statix helps you solve:
Statix leverages giving you the ability to write a piece of HTML once and then include it across multiple HTML template files.
Editing a navigation link across 10 static HTML pages? No problem. Want to change a piece of footer text across the whole of your site templates? Easy!
Simply manage one code snippet and include it wherever you want it to appear in each HTML template.
Statix uses Kickoff and Grunt to give you a minimal starting point for your front-end projects. Just enough structure; no extra bloat.
Write content in Markdown
One of the biggest pain points for managing content is having to write it in plain HTML.
Because Statix uses Assemble, it brings together the power of using a templating language (such as Handlebars), with the flexibility of being able to write content using .
This means that content editors can update a much more readable markdown file, rather than dig into HTML syntax.
Fast starting point
Statix gives you a great base to get up and running as quickly as possible. Whether templating a full site or just spinning up a prototype, Statix tries to get out of your way so you can start coding.
There’s no complicated config to mess around with before you start. Once installed, simply typing
grunt serve into the terminal will spin up a local server that you can see your project change in realtime as you edit it.
Statix can be extended as much or as little as you like.
The base setup of Statix only utilises a very small amount of Assemble’s features. If you want to use it’s more powerful templating functionality then you can extend this in the usual way, as you would if using Assemble on it’s own without the base Statix setup.
What’s under the hood
Statix is essentially a simple setup of , a powerful static site generator, combined with , a minimal front-end base framework, all tied together with a few handy setup tasks.
Collectively, this gives you a framework that streamlines the creation of maintainable, flexible HTML templates with virtually no project setup required.
Should you wish to rip out the CSS (or SCSS) and JS and replace it with a structure or framework you feel more comfortable with (such as Bootstrap), that is also very simple with a couple of small changes to the project setup.
- Git clone:
- SVN checkout:
svn checkout https://github.com/tmwagency/statix your-project-folder
Getting started with Statix
- Download or clone the git repo. To clone run
git clone https://github.com/tmwagency/statix.git your-project-folder
- Ensure you have Sass, Node and Grunt installed, as Statix needs these dependencies to operate.
- Install the project dependencies by running
npm installfrom the root of the directory.
grunt serve. This will build your project for the first time and use the connect module to start a static web server for your templates.
- Build your templates using Statix!
Compiled template files are created in the
/dist folder at the root of the project, and this can be changed in the Gruntfile if you would rather compile elsewhere.
/js/dist and Sass is compiled to the
Installing Statix dependencies
- Install Node from
- Install Grunt CLI -
npm install -g grunt-cli
Once these dependencies are installed, see ‘Getting started with Statix’ for instructions on runnign your project.
Further documentation and demos
Statix is a combination of three tools; , and . The documentation for these tools should be looked at for extending the base setup of Statix.
- See the for all demos and information relating to Kickoff
- Check out the for more information on Assemble.
- Read the excellent to make a start with Grunt.
Using your own front-end framework
Don’t want to use Kickoff?
That’s cool – Statix has been built so the you can use any front-end framework you like.
To replace the SCSS
Delete the files in the /scss folder, replacing them with your framework of choice.
Next, go to
/_grunt-configs/css.js in the root of the project and change all references of
kickoff.css to whatever you have decided to call your main SCSS file.
Finally, change the reference to the compiled CSS file in the
To replace the JS
Delete the files in the
/js folder, replacing them with your own structure.
Replacing anything else…
Statix uses Grunt to take care of simple tasks like minification and concatenation.
If you know Grunt, you can change pretty much any aspect of the config as you would any other Grunt project. If you don’t like certain default config options of Statix, fork the repo and change them!
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -m 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
Developed by & .
Uses the excellent static site generator , which is developed and maintained by and Brian Woodward.
If you’re using Statix we’d love to hear about it; give us a shout on Twitter, or and let us know how you’re using it.