Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A template app for using Neo4j from Node.js.
JavaScript HTML CSS
Branch: master

Merge pull request #18 from aseemk/v2

Update for node-neo4j v2
latest commit 47528b307b
@aseemk authored

Build Status

Node-Neo4j Template

This is a template Node.js + Neo4j app, using the node-neo4j library (available on npm as neo4j).

A demo is running on Heroku at

The app is a simple social network manager: it lets you add, remove, follow, and unfollow users. It's basic, and the UI is crappy, but hey, it's a template app. =)

So try it out, browse the code, and fork this project to get a head start on coding your own app. Enjoy!


git clone
cd node-neo4j-template
npm install

You'll also need a local Neo4j 2.x instance. Install it via, or if you're on a Mac, brew install neo4j.


Start your local Neo4j instance (e.g. neo4j start), then:

npm start

The app will now be accessible at http://localhost:3000/.

To run the tests:

npm test


This app is running on Heroku, using the free version of the GrapheneDB add-on:

You can run your own instance similarly for free:


If you prefer to deploy this sample app manually, these are the steps:

heroku create [your-app-name]
heroku addons:add graphenedb
git push heroku master

There's already a Procfile here, and the code already checks for the necessary PORT and GRAPHENEDB_URL environment variables, so your deploy should go off without a hitch!

If you're deploying in another way, the code also checks for a NEO4J_URL environment variable to support pointing to any other Neo4j database. The value of this variable should be set to the database root URL, and it can contain HTTP Basic Auth info. E.g. https://user:pass@ You can alternately pass the auth portion (user:pass) as NEO4J_AUTH.

One thing to note is that npm start is currently geared towards development: it runs node-dev instead of node. Edit scripts.start in package.json if you need to change that.


  • MIT license.
  • Questions/comments/etc. are welcome.
  • As an exercise, I built this without using CoffeeScript or Streamline. What a gigantic pain! Never again. =P
Something went wrong with that request. Please try again.