Easiest Database Ever

Try it now

var gun = Gun('https://gunjs.herokuapp.com/gun');
gun.get('example/tutorial').put({hello: "world"});

In this 1 minute tutorial, we will connect to a gun peer, create an object, and sync data in realtime.

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.

Community

Are you currently working on a project using GUN or perhaps you would like more information before you make up your mind.

We always love to be in touch with our community and listen about what you're working on and maybe we can give you a hand. Click the button below and talk to us on Gitter!

API

Gun constructor

Used to creates a new gun database instance.

gun.put

Save data into gun, syncing it with your connected peers.

gun.get

Load all data under a key into the context.

gun.back

Move up to the parent context on the chain.

gun.opt

Change the database options.

gun.path

Navigate through a node's properties

gun.on

Subscribe to realtime updated changes on a node or property.

gun.val

Read a full object without subscribing updates.

gun.set

Add a unique item to an unordered list.

gun.map

Loop over each property in a node, and subscribe to future changes. It's essentially performing a .path on each field.

gun.not

Handle cases where data can't be found.

Interactive explainers

Databases can be scary, which is why we are making a series of explainers to educate everyone. Young or old, our goal is to show you that these ideas are actually simple.

Data structures

Conflict resolution

Data security

Projects

Our GUN community is working on great projects here are the promising ones.

Geolocation app

Using GUN's location awareness, is able to track other devices and tell the user where this device in relation to their position, the updates happen in real time.

Trace game

Fun game where up to 4 users try to eliminate each other by blocking the other players path.

Connect 4 - C4

High speed games aren't the only games that benefit from real time data. Consider turn-based games: some parts of the game are slow moving, and some parts are fast (pondering a move for a while, or seeing a perfect opening and launching for it).