Skip to content
Simple Engine is a seriously simple static website engine.
HTML JavaScript CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Simple Engine

Simple Engine is a seriously simple static website engine.

Will be adding more directions and documentation here shortly.



The following is required:



If you have all the requirements installed already, you should be all set to get going. Just run the following:

$ npm install

This will install all of the node modules needed to run and build Simple Engine.


Site Configuration

You can use the config.json file in the root of the site for managing global variables you may want to use for your site. Those variables are then availible on all pages you create.

Inside of the config.json file, you can declare your variables you wish to use.

  "title": "Simple Engine",
  "url": "",
  "author": "Christopher Casper",
  "email": "",
  "site_description": "A seriously simple static generator!",
  "site_title": "Simple Engine"

Then to access them in your template, you would use the following:

{{ title }}

You can also expand upon this and use arrays or key value pairs for more data driven content.



Updates should be easy. I don't plan on doing any major breaking changes like folder names, so just make sure you do a pull form the main repo from time to time.



Simple Engine uses the swig template engine. You can find more documentation and examples on how to use it here.



All of your content/pages will live in the source/content folder. Just create a new html file and give it the same name you want for the URL. If you create a file called about.html, it will then be availible on your site at You may also nest directories for a deeper level of navigation.

There are two examples of this, one for /about and one for /products.


Local Development

To start developing locally, you need to start gulp:

$ gulp

This will start building the site, watching all files for changes, and run a local webserver of your Simple Engine site that you can view at http://localhost:8000/



When you are ready to push your site live, run:

$ gulp build

This just rebuilds a fresh version of the site without the live reload web server running.

You can’t perform that action at this time.