Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A framework for writing modular web applications in node.js
JavaScript CSS
Tag: v0.0.3

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


A framework for writing modular web applications in node.js

About jimi

Apps contain a set of (regex) URL patterns that map HTTP requests to handler methods, called views. URL patterns and views are stored in separate files, which are imported when the app is executed. Apps can be organised into a set of modules, each with their own URL and view definitions. You can build quite complex apps by hooking a module's URL patterns one of the parent module's URL patterns.

jimi currently uses a javascript conversion of the django template system (written by Simon Willison), which has been modified slightly to work with more recent versions of node.js. The template system can be hooked into your views to provide a simpler way to render your content.

To use jimi & run the example apps you must have node.js, npm and Connect installed.


To install through npm, run the following command in your terminal of choice:

npm install jimi

Example Apps

Examples are be stored in the apps directory, and will give you a starting point for building your applications. Navigate to the example directory and run:

node app.js

Then visit in your web browser.

Example App Structure

 |- app.js
 |- urls.js
 |- views.js
 |- <module_directory>
 |   |
 |   |- urls.js
 |   |- views.js
 |- <public_directory>
 |   |
 |   |- <public_file>.css
 |- templates
     |- <base_template>.html
     |- <module_directory>
         |- <template>.html
         |- <template>.html

Templates don't have to be laid out this way, but the templating example uses this layout. Public content such as static files should be placed in a folder inside your app directory. Look at either of the examples to see how they fit in.

In Development...

  • I'm considering replacing the templating system with something more lightweight as a one-to-one copy of the django templating system may not be the best way forward. This may not happen straight away though.

  • I'm also considering various node.js data modelling libraries for building the 'model' layer of jimi, so please forward any suggestions to


jimi was originally based on djangode, a node.js micro-framework written by Simon Willison. The framework still uses the djangode templating system, so he deserves heaps of credit.

Something went wrong with that request. Please try again.