Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A template app for using Neo4j from Node.js.
branch: master

Merge pull request #15 from albertoperdomo/master

Add Heroku deploy button
latest commit 8934382ce6
Aseem Kishore authored

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.0 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 test version of the GrapheneDB add-on:

If you want to run your own instance similarly, it's just one click of a button away:


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@

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.