Gun-vue is a versatile toolkit that combines the power of the peer-to-peer JavaScript database Gun with the reactivity system of Vue into small, but precise to the purpose apps for everyone to make, share, use and discard whenever we want. It offers pluggable components for UX designers to compose, easily importable composables for UI developers to use, and a 2 LOC starter Relay peer for new p2p network enthusiasts to run on almost any hardware. With growing collection of demos and documentation, Gun-Vue is open-source and accessible to everyone! ✊
@gun-vue is an open collection of interconnected building blocks designed for creating a wide range of decentralized apps for online and offline collaboration. It combines the strengths of Gun (a CRDT-based distributed graph database), Vue (a reactive JavaScript UI framework), and SEA (a web-browser cryptography adapter) to create an ecosystem of multiple app levels. The project aims to provide basic tools for everyone to participate in exploring this new graph universe and find their own way within it.
The code is organised into distinct layers under the @gun-vue npmjs.com organisation for you to install and use in your P2P apps.
The main gun-vue.js.org web-site is a demo Gun-Vue SPA, which is also automatically built into a set of desktop apps as playground and example of what can be made with it today.
Web app hosted at GitHub pages and JS.org domain
The app is accessible via the free for open source js.org subdomain since Jan 2022 and hosted at GitHub pages. It's built as a single HTML file that can be served from any domain or just opened as a local file. You can just press Save Page As... and have your local-first reactive p2p webapp with you everywhere.
Desktop app releases via GitHub Actions and Tauri
Whenever a new version of Gun-Vue is published, an automated action creates a new release draft with a full kit of lightweight native desktop apps for Windows, Mac OS and Linux with Tauri by a GitHub Action. Mobile apps are coming too. This is a very nice way to have Gun-Vue available in case of DNS interuptions. Local relay should become a part of it, especially once GUN Rust port is stable enougth to be somehow integrated into Tauri app structure. So it can be essentially a full GUN node in a <10Mb native app.
Open source code at GitHub pnpm monorepo
The code is cut into vertical slices as small interconnectable apps in the common source folder.
This means that each folder in the src directory is a convenient section of the entire codebase, holding a shared basic structure but having distinct functionality.
All the source code gets built by GitHub Actions on each tag being published. The resulting HTML code goes to the _dist folder and is deployed to the GitHub Pages static site hosting.
@gun-vue/components provides ready-to-use Vue 3 components as building blocks to implement Gun-powered interactivity in seconds.
Playground at Stackblitz.com
Native web-components may be implemented in future.
Composable functions for use with Vue 3 Composition API. They hold the core reactive logics that power the whole visual UI representation while being totally agnostic of it. You can combine these composables in Vanilla HTML+JS or import them into any of your existing static web-site builds for any realtime p2p activity.
Documentation with Typedoc and Vitepress
A simple no-store Gun server to throw at any Node.js environment. From old laptops, Raspbery Pi's and free-tier hostings to high-load VPS and dedicated servers.
Demo relay by DeFUCC
Development video blog. Watch at DeFUCC youtube channel
You can find shorter feature announcements there along with longer live coding sessions.
- Clone this monorepo
- Install pnpm
- Use
pnpm ito recursively install all dependencies in the workspaces - Use
pnpm run dev,pnpm run docsandpnpm run appscripts in the root folder to run corresponding dev servers. - Use
buildsscript to have all packages built and ready to be published in the_distfolder.
corepack enable
pnpm i
pnpm run builds
open ./_dist/index.htmlMONERO wallet: 852xu44krejYiBrP8xqWQeXT1VgiBq5M1g1JW8RpRdMX3a1wpqZ1u5VGR5HPFyvvDY5MUJ4iZTaEwNm5ujZFxn6FSiHpYhL