> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/estebanrfp/gdb/llms.txt
> Use this file to discover all available pages before exploring further.

# GenosDB Examples and Community Projects

> These are simple, typically single-file demonstrations designed to illustrate core GenosDB functionalities. They are usually hosted directly from this…

[![image](https://i.imgur.com/orglGSe.png)](https://i.imgur.com/orglGSe.png)

# GenosDB Examples and Community Projects

This page showcases various examples demonstrating GenosDB's capabilities. It's divided into:

1. **Basic Examples:** Simple, self-contained examples illustrating specific features.
2. **Awesome Projects & Showcases:** More complex projects, applications, or tools that utilize GenosDB, created by us or the community.

***

## Basic Examples

These are simple, typically single-file demonstrations designed to illustrate core GenosDB functionalities. They are usually hosted directly from this repository's [examples](https://github.com/estebanrfp/gdb/tree/main/examples) directory.

### [Basic To-Do List](https://estebanrfp.github.io/gdb/examples/todolist.html)

A simple real-time app to manage pending tasks. Ideal as a minimal example.

### [Advanced To-Do List](https://estebanrfp.github.io/gdb/examples/advanced-todolist.html)

A complete task management app, featuring real-time syncing, task filtering (all/active/completed), inline editing, persistent storage, and a clean responsive UI. Ideal for showcasing reactive CRUD operations.

### [Status List](https://estebanrfp.github.io/gdb/examples/status-lists.html)

This example demonstrates running Multiple, query-filtered db.map() listeners in real-time.

### [Infinite Scroll](https://estebanrfp.github.io/gdb/examples/infinite-scroll.html)

Example of dynamic content loading while scrolling.

### [Pagination](https://estebanrfp.github.io/gdb/examples/pagination.html)

Blog Grid with Mixed Pagination and Persistence.

### [Real-Time Chat](https://estebanrfp.github.io/gdb/examples/chat.html)

A basic chat with real-time updates.

### [Real-Time Kanban](https://estebanrfp.github.io/gdb/examples/kanban.html)

A basic kanban with real-time updates.

### [Custom Cursor](https://estebanrfp.github.io/gdb/examples/cursor.html)

Move your mouse cursor in realtime.

### [P2P Collaborative Whiteboard](https://estebanrfp.github.io/gdb/examples/whiteboard.html)

Build complex real-time apps without a backend. This collaborative whiteboard runs entirely peer-to-peer, powered by the simplicity of GenosDB.

### [Instant Search](https://estebanrfp.github.io/gdb/examples/search.html)

Implementation of a quick search for GDB Operator testing.

### [Real-Time Paste](https://estebanrfp.github.io/gdb/examples/paste.html)

A textarea that syncs content in real-time with GenosDB.

### [Tic Tac Toe Game](https://estebanrfp.github.io/gdb/examples/tictactoc.html)

A Tic Tac Toe game using GenosDB for real-time player synchronization.

### [Real-Time Audio Room](https://estebanrfp.github.io/gdb/examples/audio-streaming.html)

A real-time peer-to-peer audio streaming app using GenosDB’s room feature. Supports microphone broadcasting, automatic peer discovery, and live audio playback between multiple users in the same session. Includes real-time voice activity detection to visually indicate when a peer is speaking.

### [Real-Time Video Room](https://estebanrfp.github.io/gdb/examples/video-streaming.html)

A real-time peer-to-peer video streaming app using GenosDB’s room feature. Supports webcam broadcasting, automatic peer discovery, and live video playback between multiple users in the same session.

### [Real-Time File Streaming](https://estebanrfp.github.io/gdb/examples/file-streaming.html)

A real-time peer-to-peer File Streaming app using GenosDB’s room feature.

### [Real-time location sharing](https://estebanrfp.github.io/gdb/examples/share-locations.html)

An interactive example that enables multiple users to share their live location on a map in real time, using Leaflet for visualization and GenosRTC as the P2P transport layer.
Each participant can start or stop location sharing, track their own path, and follow other connected users’ movements live.

### [Real-Time Geolocation](https://estebanrfp.github.io/gdb/examples/geo.html)

Detects your current position, seeds sample nodes around it, and finds the ones within 50 km using the **Geo module's** `$near` operator — markers and results update on a Leaflet map wherever you are.

### [Real-Time collaborative rich‑text editor powered by GenosDB](https://estebanrfp.github.io/gdb/examples/collab.html)

A real-time collaborative rich‑text editor powered by GenosDB: live typing sync, remote cursors/selections, RBAC + WebAuthn auth, Markdown/HTML split preview with draggable splitter, version history panel, file sharing, and video room.

### [Basic Collaborative Editor powered by GenosDB](https://estebanrfp.github.io/gdb/examples/collab-editor-basic.html)

A minimal, no-login collaborative text editor — the basic counterpart to the rich-text editor above. Shows live presence (online peers) and debounced auto-save on top of GenosDB's automatic P2P sync: writes via `db.put()` and a reactive `db.get(id, callback)` subscription, with concurrent edits resolved by the Hybrid Logical Clock — no manual channels or timestamps.

### [Secure, Decentralized & Collaborative Notes App powered by GenosDB](https://estebanrfp.github.io/gdb/examples/notesdev.html)

Secure, Decentralized & Collaborative Notes App powered by GenosDB
A minimalist and secure note-taking app showcasing decentralized identity management (Mnemonic & WebAuthn Passkeys), real-time note sharing with granular read/write permissions enforced via P2P security middleware, live full-text search, and a responsive UI with light/dark modes.

### [Real-time IoT Thermostat Control powered by GenosDB](https://estebanrfp.github.io/gdb/examples/thermostat.html)

A real-time peer-to-peer thermostat control demo showcasing GenosDB's reactive synchronization. Multiple users can adjust target temperature, toggle eco-mode (Leaf), and set away status — all changes instantly sync across connected browsers without any backend server. Demonstrates `db.put()`, reactive `db.get()` subscriptions, and P2P room events for peer counting.

### [DevConnect — P2P Developer Network powered by GenosDB](https://estebanrfp.github.io/gdb/examples/devconnect.html)

A decentralized developer-networking app and full GenosDB showcase: passwordless identity via the Security Manager (mnemonic + WebAuthn passkeys) behind a centered login modal, a real-time developer directory powered by `db.map()`, public and private P2P chat over GenosRTC data channels, GitHub profile import, and interactive Leaflet maps with geo-tagged peers.

***

## Security Manager (SM) Examples

### [Secure Auth UX Demo](https://estebanrfp.github.io/gdb/examples/sm-auth-demo.html)

A self-contained example demonstrating a secure and intuitive user authentication (UX) flow using the GenosDB Security Manager (SM) module. It implements best practices for Mnemonic-based registration and WebAuthn (Passkeys) authentication, serving as a starter template for decentralized applications.

### [Security Manager (SM Testbed)](https://estebanrfp.github.io/gdb/examples/sm-testbed.html)

A hands-on tour of the Security Manager — one-click demo identities, per-user encryption and RBAC — built around a **guided scenario** that shows how a signed role grant propagates **P2P to an offline user via a relay peer, with the superadmin offline**. Open it in three separate browsers to watch authority survive the signer going away.

### [SM RBAC Chat (WebAuthn Example)](https://estebanrfp.github.io/gdb/examples/chatrbac.html)

RBAC Chat with WebAuthn Security.

### [SM RBAC WebAuthn Example](https://estebanrfp.github.io/gdb/examples/webauthn.html)

RBAC Simple WebAuthn Security.

### [SM Encryption Example](https://estebanrfp.github.io/gdb/examples/encryption.html)

SM Encryption & Decryption Example

### [Oplog Audit Module](https://estebanrfp.github.io/gdb/examples/todolist-audit.html)

Provides real-time auditing of oplog entries, detect spam and prohibited content

### [SM Secure Notes](https://estebanrfp.github.io/gdb/examples/sm-secure-notes.html)

A single-page HTML application demonstrating secure, real-time, peer-to-peer note sharing. It utilizes GenosDB and its SM module for identity management, implicit client-side encryption of notes, and secure P2P data synchronization.

### [ACLs + Governance Testbed — The Full Security Model](https://estebanrfp.github.io/gdb/examples/acls.html)

The complete GenosDB security model in one demo — zero-trust, governance and node-level ACLs. Open it in two or three windows: one becomes the demo superadmin with a single button and runs a governance console (live user/role list and signed promotions); the others join as Alice & Bob — zero-trust guests that cannot write until the superadmin's governance rule promotes them to `user` — and then create, share and revoke notes per user with `db.sm.acls.set` / `grant` / `revoke` / `delete`. Referenced from the [SM ACLs Module guide](https://github.com/estebanrfp/gdb/blob/main/docs/sm-acls-module.md) and the [Governance guide](https://github.com/estebanrfp/gdb/blob/main/docs/governance.md).

### [Governance — Role Promotion & Demotion](https://estebanrfp.github.io/gdb/examples/governance.html)

A live viewer of GenosDB's governance engine, which resolves each user's role by **last-match-wins**. Open it in two windows: one becomes the demo superadmin with a single button and runs the engine; the other logs in as Alice (or Bob) — a zero-trust guest promoted to `user` in \~5 seconds — then votes 👍 to climb a merit ladder (`user` → `manager` at 2 points → `admin` at 4 points) and 👎 to **auto-demote** (no explicit demotion rules — losing the condition simply lets a lower rule win). A live role roster and a signed role-transition log show every promotion and demotion. Full guide: [Governance](https://github.com/estebanrfp/gdb/blob/main/docs/governance.md).

***

## Tools & Testbeds

### [GenosDB - Mesh Network Monitor](https://estebanrfp.github.io/gdb/examples/mesh-cells-monitor-d3.html)

**The reference monitor** for GenosDB networks: an interactive force-directed graph (D3.js) of the Cellular Mesh topology — cells, bridges, peers you can drag — with live network metrics, dynamic TTL, a per-cell peer roster, and Fallback Servers identified as violet `SRV` nodes. Uniquely, it also taps the sync protocol itself (`db.use`): every real database operation (PUT / DEL / LINK) is animated traveling across cells and bridges, so you watch GenosDB work — not just its chat channel.

**Visual variants** — same protocol, different aesthetics: [Lite](https://estebanrfp.github.io/gdb/examples/mesh-cells-monitor-lite.html) (lightweight Canvas) · [Retro](https://estebanrfp.github.io/gdb/examples/mesh-cells-monitor-retro.html) (ASCII CRT terminal) · [Modern](https://estebanrfp.github.io/gdb/examples/mesh-cells-monitor-modern.html) (minimalist Canvas) · [3D Particles](https://estebanrfp.github.io/gdb/examples/mesh-cells-monitor-particles.html) (Three.js).

### [GenosDB - Mesh Cells Reach Probe](https://estebanrfp.github.io/gdb/examples/mesh-cells-reach-probe.html)

A minimal instrument for observing how peers partition into cells. Open it in several tabs — each is a peer; past 10 peers the mesh organizes into cells linked by elected bridges, and the panel reports how many peers land in each cell and who bridges them. Press **PING** to broadcast a `hello` that every peer answers with `world`, so **reach N/N** confirms the message still reaches every peer across the cells, with the coverage latency.

### [GenosDB - Perf & Stress Test](https://estebanrfp.github.io/gdb/examples/perf-stress-test.html)

A dedicated environment for benchmarking GenosDB under high-load scenarios: chunked mass insertions with honest metrics (**ops/s over pure write time**, fulfilled vs failed), realtime subscription counters, configurable `saveDelay` / `oplogSize` knobs, and a **Sync Protocol Observatory** that counts `sync` / `deltaSync` / `fullStateSync` messages live so you can watch the Hybrid Delta Protocol switch between delta and full-state catch-up across browsers.

### [GenosDB - Query Playground](https://estebanrfp.github.io/gdb/examples/sandbox.html)

A testing environment to experiment with GDB Operators and Natural Language for Queries examples

### [GenosDB - Geo Query Playground](https://estebanrfp.github.io/gdb/examples/sandbox-locations.html)

An interactive playground for the **Geo module**: pick or edit `$near` / `$bbox` queries and watch the matching places render live on a Leaflet map of New York. Ideal for learning the documented geo query syntax.

### [Edge Operator Testbed](https://estebanrfp.github.io/gdb/examples/edge-operator-testbed.html)

`$edge` Operator Testbed environment to experiment with GenosDB Operators

examples/edges-operator-testbed.html

### [Data Relationships](https://estebanrfp.github.io/gdb/examples/relations.html)

Visualization of graph relations in realtime.

### [Test Links](https://estebanrfp.github.io/gdb/examples/testlinks.html)

A tool to verify and validate the functionality of hyperlinks within the application.

***

## Awesome Projects & Showcases

A curated list of more complex or notable projects, applications, or tools built with or for GenosDB. Contributions are welcome!

***

### [To-Do-List](https://github.com/estebanrfp/To-Do-List)

Distributed To-Do List Application with GenosDB and Vanilla Javascript

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dChat](https://github.com/estebanrfp/dChat)

Distributed Chat Application with GenosDB and Vanilla Javascript.

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dGroup](https://github.com/estebanrfp/dGroup)

Distributed Group Chat Application with GenosDB and Vanilla JavaScript

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dKanban](https://github.com/estebanrfp/dKanban)

Distributed Real-time Kanban board that stores data in GenosDB.

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dCMS](https://github.com/estebanrfp/dCMS)

Distributed CMS Application with GenosDB and Vanilla JavaScript

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dVoting](https://github.com/estebanrfp/dVoting)

Distributed Voting Application with GenosDB and Vanilla Javascript

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dProp](https://github.com/estebanrfp/dProp)

Real-Time P2P Real Estate Proof of Concept powered by GenosDB

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dSocial](https://github.com/estebanrfp/dSocial)

A from-scratch decentralized social network and the most complete GenosDB showcase: communities, posts, polls, votes, karma + badges, zero-trust governance (signed role promotion), end-to-end encrypted chat with hybrid public/private rooms, 1:1 P2P file transfer, live typing/presence and field-level `$text` search — vanilla JavaScript, one dependency, no framework. **[▶ Live demo](https://dsocial-genosdb.netlify.app)**.

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [Pixel-Painting](https://github.com/estebanrfp/Pixel-Painting)

Distributed Pixel Painting Application with GenosDB and Vanilla Javascript

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [dMarket](https://github.com/estebanrfp/dMarket)

A GenosDB × blockchain showcase: a live Polygon (Amoy) NFT marketplace **mirrored into GenosDB** — the chain is the source of truth, while GenosDB is the reactive, offline-capable, P2P read layer (`db.map`). The Security Manager identity doubles as the on-chain wallet, so **one key signs both your P2P operations and your Polygon transactions** (no MetaMask). Faithfully extracted from OVGrid's marketplace — UI and all — as a \~1,600-line, no-build reference that points back to the full project below. Vanilla JavaScript.

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

### [OVGrid - Open Virtual Grid](https://ovgrid.com/)

WebXR Educational Virtual World - Real-time shared experiences. \~ By [estebanrfp](https://github.com/estebanrfp)
Project progress videos - [@ovgrid](https://odysee.com/@ovgrid:d)

### [Hōkō — Community BMTC Bus Tracking](https://github.com/soulsam480/hoko)

A community-driven, serverless bus tracking app for Bangalore (BMTC): riders inside a bus become live GPS "feeders" over **GenosRTC data channels** (one channel per route), while everyone else watches buses move on a Leaflet map — with a city-wide presence channel for feeder discovery across routes, 50 m haversine clustering of nearby buses, and smart session revive. Built with Preact + Signals and local SQLite (sqlocal/OPFS) for GTFS data; **GenosDB replaced the project's entire custom WebSocket backend (\~1,000 lines) in a single evening**.

*By: [Sambit Sahoo (soulsam480)](https://github.com/soulsam480)*

***

## Integrations

Plugins, bridges, and adapters that bring GenosDB into other platforms, engines, and frameworks. *(Different from GenosDB's own optional **modules** — SM, NLQ, GEO, rx, audit.)*

### [godot-genosdb — Serverless P2P multiplayer for Godot](https://github.com/estebanrfp/godot-genosdb)

A drop-in **Godot 4** plugin that adds real-time **P2P multiplayer** to Web exports via GenosDB — no backend. The API **mirrors GenosDB** (`join` / `send` / `put` / `map` / `remove`), so using it teaches the real GenosDB API. Ships with a cozy Stardew-style co-op farm demo (chop trees in a shared world, P2P chat). **[▶ Live demo](https://estebanrfp.github.io/godot-genosdb/)**.

*By: [Esteban Fuster Pozzi (estebanrfp)](https://github.com/estebanrfp)*

***

**Contributing to Awesome Projects:**
If you have a project using GenosDB that you'd like to showcase, please [open an issue](https://github.com/estebanrfp/gdb/issues) with the details, or submit a pull request to this page!