Fear the Goblin! - An amazing, simple and fun database for humans
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.


shieldsIO shieldsIO shieldsIO shieldsIO Build Status



Fear the Goblin!

An amazing, simple and fun database for humans

Goblin Philosophy

  • Coding is fun, so databases must be fun too.
  • Data is the king.
  • Data should be stored in the system as a file whenever a change happens.
  • Data storage in the system must be hackable.
  • The database can lead or connect your server components.
  • Events are great... because we are asynchronous.
  • We prefer facts over promises: facts are there, promises maybe yes or not. In fact, we're talking about callbacks.
  • Data is not the only stuff that can be store in a database.
  • We prefer ambush functions over lambda functions. As you know... we're talking about anonymous functions.


const GDB = require("@goblindb/goblindb");

const goblinDB = GDB(function(dbError) {
    if (dbError) {
        throw dbError;

    console.log("Fear the Goblin!")

    // Events supported
    goblinDB.on('change', function(changes){
        console.log("-- change detected!:", changes)

    // Read all Database...
    const originalData = goblinDB.get();
    console.log("originalData:", originalData);

    // Store data...
    goblinDB.set({"data": "world!", "data2": "Hiiiii"});

    // Update date...
    goblinDB.update({"new data": "hellooo....", "new array": ["aaaa", true, 2], "data": "cambiado!"})

    // Read all Database...
    const currentData = goblinDB.get();
    console.log("currentData:", currentData)

Check the official documentation in our website


You can run a demo in 4 steps!

  1. Clone this repository
    git clone https://github.com/GoblinDBRocks/GoblinDB 
  1. Enter in the folder
    cd GoblinDB
  1. Install the dependencies
    npm install
  1. Run fear_the_goblin.js
    node demo/fear_the_goblin.js


You can test your changes...

npm test

Future Implementations

  • Support to chain methods. Issue 50
  • Add Pugins system. Issue 12
  • Plugin documentation example. Issue 56
  • Add basic query methods as a plugin. Issue 54
  • Add Avance query methods as a plugin. Issue 55
  • Add support to .once() method for events. Issue 51
  • Add support to UID in events. Issue 53
  • Add additional support to Backup Goblin with other databases like Firebase, Mongo... in real time as a plugin.Issue 52
  • Support multidimensional navigation in the database (.ref() method). Using get instead of .ref but same functionality. Issue 17
  • Additional events to support (config changes, etc...).
  • Full documentation in JSDoc.
  • Gulp Tasks Improvement.
  • Test support for Events using Sinon.
  • Test refactor in order to separate more the test cases.


  • GoblinSocket. WebSocket interface for GoblinDB using SocketIO

Goblin Team

Those are the amazing people which have contributed to this project:

Ulises Gascón Co-leader

Sebastián Cabanas Co-leader

Carlos Hernandez Co-leader

Leyla Vieira Contributor (Web)

Santiago Trigo Porres Contributor

Andrés Contributor

Alvaro Contributor

Jose Contributor (Moral support :trollface:)


v.0.1.0 The Kraken!

🎉🎉 Finally, here we are! Releasing the version one, the first production quality version available ever. We're very proud to reach this step in the project life! 🎉🎉

After almost one month working with the last version v0.0.11 Meigas we're pretty sure the database is reliable to be used in a production environment. So here we are releasing the kraken!

Bug fixes:

  • Improve and update the project demo.


  • Evangelization process is going on (Talks, documentation, workshops...)
  • We are looking for active evangelists, ping us ;-)

v.0.0.11 Meigas!

We've found bugs... bugs which didn't make sense, like meigas it looks like there is none but in the end there were some big bugs like db not storing data in the json and other similar "features" :trollface:

Wellcome to the new members of the team ❤️ Andrés @drewler (The Galician Tigger), Santiago @trigoporres (El potro de Vallecas) and Alvaro @alvarogtx300 (El ausente :trollface:)

People which have contributed to this release:

Sebastián Cabanas Co-leader

Carlos Hernandez Co-leader

Ulises Gascón Evangelist and Consultant

Santiago Trigo Porres Contributor 🎉🎉

Andrés Contributor 🎉🎉

Alvaro Contributor 🎉🎉

Main target:

  • Version 1 candidate.
  • Remove eval. Improved how data gets saved and loaded.
  • Various code improvements.
  • Events improvements.
  • Add callback to goblin init method (now async loading json db files).
  • Allow using a custom pointer symbol (you can use '/' for example, instead of '.' (default)). Configurable in init method config. Issue 36 Pull Request 42 Thanks to Santiago Trigo Porres 💯
  • Add delete and truncate methods to database. Issue 38 PR Pull Request 34
  • Add error events hook. Now you can listen to goblinDBInstance.on('error', callback...). Issue 37 Pull Request 43 Thanks to Alvaro 💯
  • Add test cases for events. Issue 8 Pull Request 44
  • Add errors FAQ and improve messages adding links to the docs (in dev mode only). Issue 14 Pull Request 46 Thanks to Andrés 💯
  • Add ambush functions events hooks. Now you can listen to ambush-change, ambush-add, ambush-update and ambush-remove.
  • Add support for detaching all events of the same type for all the callbacks associated. Ex. Detaching the listeners for 4 different callbacks on change event.

Bug fixes:

  • Lots of bugs. I don't even now where to start haha.


  • Add methods delete and truncate to the database.
  • Added a callback to Goblin init method which will be called when the db is ready to work (load data from file async).
  • Allow using a custom pointer symbol. Now you can use '/' (firebase friendly).
  • New code structure (feature only for developers), wich improve stability.
  • Test improvements (feature only for developers), wich improve stability.


  • Great job and support from Alvaro, Santiago Trigo Porres and Andrés (now in GoblinDB team) 🎉🎉
  • This version is a good candidate for v0.1.0
  • Evangelization process is going on (Talks, documentation, workshops...) Last event was T3chfest 2018 and all osw events 👍
  • We are looking for active evangelists, ping us ;-)

v.0.0.10. New Drakkar!

Main target:

  • Refactor the main structure to improve maintainability.
  • Improve all the test cases, to cover well all the code.

Bug fixes:

  • Lot of bugs when adding or updating ambush functions.
  • Improved error messages and reasons (some of them was not consistent).


  • Travis added to the project
  • Silence mode.
    • Production mode.
    • Development mode.
  • New code structure (feature only for developers), wich improve stability.


  • Great job and support from @Sediug (now in GoblinDB team)
  • Evangelization process has been started (Talks, documentation, workshops...)
  • We are looking for active evangelists, ping us ;-)


Main target:

  • Improve architecture & compatibility


  • Native Events now supported.
  • No need to use Object.observe or proxy ECMA6 alternatives.


Main target:

  • Ambush support

Bugs Fixed:

  • No need to require http module, in documentation examples


  • Database testing improved
  • Added optional features like parameters and callbacks for Ambush (lambda) functions
  • Added automatic save for Ambush
  • Added .goblin extension in order to store ambush operations
  • Added Testing to support ambush features
  • Added goblin.ambush as container
  • Added goblin.ambush.add(),
  • Added goblin.ambush.remove(),
  • Added goblin.ambush.update(),
  • Added goblin.ambush.list(),
  • Added goblin.ambush.details(),
  • Added goblin.ambush.run()


  • Readme improved




  • Documentation improved

Bugs Fixed


Notes: Just to solve issues with NPM.


Main target:

  • Develop the basics key functionalities (methods)
  • Key/Value operative database
  • Event support
  • Database recorded as file
  • Minimum config setup


  • Added support to JSDoc
  • Added Gulp Tasks
  • Added Basic Testing with Mocha, Chai and Istanbul
  • Added .editorconfig
  • Added esLint support
  • Roadmap added
  • Added File structure
  • Added minimal validation
  • Added basic documentation
  • Added GoblinDB as Module
  • Added GoglinDB Helpers as an independente module
  • Added support to store the data on demand as JSON
  • Added full support to events
  • Added support to key changes in events
  • Added Method on
  • Added Method off
  • Added Method getConfig
  • Added Method setConfig
  • Added Method stopStorage
  • Added Method startStorage
  • Added Method get
  • Added Method push
  • Added Method set
  • Added Method update



Notes: Just a "Hello world"

Dev status: Build Status