Building static empires with node.js.
Last updated 8 years ago by felixge .
BSD · Original npm · Tarball · package.json
$ cnpm install romulus 
SYNC missed versions from official npm registry.


Building static empires with node.js.

Install: [sudo] npm install -g romulus


Romlus is a static site generator (like jekyll) featuring:

  • a clear folder convention
  • ejs template processing
  • generating css from less files
  • a local development server acting like github pages


  • romulus deploy for github pages deployment
  • page scripts that run before rendering
  • github flavored markdown
  • blogging

You should use romulus if you want a simple tool for creating static github pages with node.js.

Creating a static page

Create a new directory, and inside this directory create the folder structure below:

Note: Only the pages folder is required, the other folders are optional.


Now create a file called pages/index.html and put some HTML into it:

<p>Hello World</p>

Run this to generate your static site:

$ romlus my-site

You should now see a new folder called my-site containing your index.html page exactly as you wrote it.

Alternatively you could run the local development server at http://localhost:8080/ by typing this:

$ romulus


In order to make this more interesting, let's say you want to wrap your new page in a fancy layout. To do this you need to change you pages/index.html file like this:

<% this.layout = 'default' %>
<p>Hello World</p>

Now you need to create the layout itself, so add a file called layouts/default.html:

<!doctype html>
    <meta charset="UTF-8">
    <title>My static empire</title>

    <link rel="stylesheet" type="text/css" href="/css/main.css" />
    <script src="/js/main.js"></script>
    <h1>My Header</h1>
    <%- page %>

That's it, you should now see your page being rendered inside your template!

Generating css from less files

Now that you have this wonderful site, you probably want to style it. To do so, create a file called public/css/main.css:

    color: #0080FF;

Sweet, your headline is now featuring my favorite color!

Static file support

Any file placed in the public folder will be included at the top level of the build output folder. The local development server also supports serving them.

Page scripts

work in progress ...

Deploying to github pages

work in progress ...


MIT License.

Current Tags

  • 0.1.1                                ...           latest (8 years ago)

12 Versions

  • 0.1.1                                ...           8 years ago
  • 0.1.0                                ...           8 years ago
  • 0.0.10                                ...           8 years ago
  • 0.0.9                                ...           8 years ago
  • 0.0.8                                ...           8 years ago
  • 0.0.7                                ...           8 years ago
  • 0.0.6                                ...           8 years ago
  • 0.0.5                                ...           8 years ago
  • 0.0.4                                ...           8 years ago
  • 0.0.3                                ...           8 years ago
  • 0.0.2                                ...           8 years ago
  • 0.0.1                                ...           8 years ago
Maintainers (2)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (8)
Dev Dependencies (0)
Dependents (2)

Copyright 2014 - 2016 © |