gun

npm Travis Gitter FOSSA Status GUN is a realtime, distributed, offline-first, graph database engine. Doing 15M+ ops/sec in just ~12KB gzipped. > Warning: We’re merging 0.5 branch into Master, you may experience some hiccups - please report them!

Why?

- Realtime - It may be trivial to get realtime updates with socket.io or something, but what you do not get is state synchronization. GUN does this for you out of the box, assuring that two users’ simultaneous updates won’t concurrently break each other. - Distributed - GUN is peer-to-peer by design, meaning you have no centralized database server to maintain or that could crash. This lets you sleep through the night without worrying about database DevOps - we call this “NoDB”. From that, you can build decentralized, federated, or centralized apps. - Offline-first - GUN works even if your internet or cell reception doesn’t. Users can still plug away and save data as normal, and then when the network comes back online GUN will automatically synchronize all the changes and handle any conflicts for you. - Graph - Most databases force you to bend over backwards to match their storage constraints. But graphs are different, they let you have any data structure you want. Whether that be traditional tables with relations, document oriented trees, or tons of circular references. You choose.

Quickstart

- Try the interactive tutorial in the browser (5min ~ average developer). - Or run the NodeJS examples npm install gun && cd node_modules/gun && npm start (5min ~ average developer). > Note: If you don’t have node or npm, read this first. > If the npm command line didn’t work, you may need to mkdir node_modules first or use sudo. - An online demo of the examples are available here: http://gunjs.herokuapp.com/ - Or write a quick app: (try now in jsbin) html <script src="http://rawgit.com/amark/gun/master/gun.js"></script> <script> // var Gun = require('gun'); // in NodeJS // var Gun = require('gun/gun'); // in React var gun = Gun(); gun.get('mark').put({ name: "Mark", email: "[email protected]", }); gun.get('mark').on(function(data, key){ console.log("update:", data); }); </script> - See this module for GraphQL support.

Support

- Help support development: https://www.patreon.com/gunDB ! - Ask questions: http://stackoverflow.com/questions/tagged/gun ? - Chat with us: https://gitter.im/amark/gun .

Documentation

Related Repositories

gun

gun

A realtime, decentralized, offline-first, graph database engine. ...

gun

gun

HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP. ...

onfire.js

onfire.js

:gun: onfire.js is a simple events dispatcher subscribe / publish library (< 1kb). async, simple and usefull. ...

cdogs-sdl

cdogs-sdl

Classic overhead run-and-gun game ...

shotgun

shotgun

For the times you need more than just a gun. ...


Top Contributors

amark PsychoLlama alexlafroscia metasean Stefdv toka forrestjt allenhartwig coolaj86 HelloCodeMing jokesterfr miclill djmrr PenguinMan98 sbeleidy TFarla ayurmedia

Dependencies

package version
aws-sdk >=2.41.0
formidable >=1.1.1
ws ~>2.2.3
dev uws ~>0.14.1
express >=4.15.2
hapi ^16.1.1
inert ^4.2.0
ip ^1.1.5
mocha >=3.2.0
panic-manager ^1.2.0
panic-server ^1.1.0
uglify-js >=2.8.22

Releases

-   v0.3.4 zip tar
-   v0.3.3 zip tar
-   v0.3.2 zip tar
-   v0.3.1 zip tar
-   v0.3.0 zip tar
-   v0.2.5 zip tar
-   v0.2.4 zip tar
-   v0.2.3 zip tar
-   v0.2.0-alpha-1 zip tar
-   v0.0.9 zip tar
-   v0.0.9-n zip tar
-   v0.0.9-m zip tar
-   v0.0.9-l zip tar
-   v0.0.9-i zip tar