Skip to content
rb
roadbeat

How roadbeat works

A decentralized ecosystem of purpose-built components.

No single company controls the network. Every part is open source.

Run a Node

Architecture Overview

The roadbeat ecosystem consists of independent, self-hosted components that communicate through standardized APIs and signed content.

Schema Registry
Context Directory

Goals · Interests · Location

Discovery Nodes

Search · Teasers · Facets

Studio Node (CMS)

CMS · Publishing · Content

Web Client
Mobile App
Content Pods

Schema Registry

The DNA of structured content.

Stores JSON Schema definitions for all 100+ content types. Versioned, signed, governed by a German e.V.

Context Directory

Your goals, interests, and location - privacy-first.

The single source of truth for personal consumer data. Goal portfolios, interest profiles, geographic context. Synced across all devices.

Discovery Nodes

Distributed search engines for structured content.

Index content teasers from publishers. Faceted search, geo-queries, and goal-based matching via Elasticsearch.

Studio Node (CMS)

Full headless CMS for publishers. Self-hosted, open source.

Content authoring with rich form schemas, asset management, publishing pipeline, version control, user management.

Content Pods

Portable content hosting for individuals.

Static content hosting for individual publishers. Serves full content with integrity verification.

Web Client & Mobile App

Consume and publish from any device.

Goal management, content discovery, publisher following, bookmarks. Full offline support on mobile.

How content flows from creation to discovery

1

Publisher creates structured content in Studio Node

2

Studio validates against JSON Schema from Schema Registry

3

Studio generates teaser and signs it with Ed25519

4

Signed teaser is pushed to Discovery Nodes

5

Discovery Node indexes teaser in Elasticsearch

6

User reviews goals via Compass in Web Client or Mobile App

7

App queries Discovery Nodes based on goal-derived filtersets

8

Matched teasers returned with "Why am I seeing this?" reasons

9

User clicks teaser - full content loaded from publisher's server

Open source by conviction, not by marketing.

Apache 2.0

Schemas & Content Pods

Maximum adoption, no server component

AGPL 3.0

Studio CE, Registry, Context Dir, Discovery Nodes, Clients

Protects against SaaS competition - anyone who modifies must share back

Commercial (BSL 1.1)

Studio Pro Plugins

Funds development; never published, never in CE repo

CC BY 4.0

Documentation

Open knowledge

Competitors can fork the CE codebase - AGPL ensures improvements come back. But Pro plugin source code is never public. This is how we fund sustainable open-source development.

GDPR isn't an afterthought - it's the architecture.

Privacy by Design

No cross-site tracking. Social graph stored client-side. Field-level encryption. Explicit consent for everything.

Data Sovereignty

European hosting (Hetzner default). No international transfers without consent. Full data portability built in.

Transparency

"Why am I seeing this?" on every item. Open-source matching logic. Published moderation policies.

User Control

Users control their filtering rules. No hidden manipulation. Export and delete at any time.

roadbeat is designed for compliance with DSA, DMA, GDPR, and the AI Act from day one - not as a retrofit.

Help build the network

roadbeat is decentralized. The more nodes, the more resilient and diverse the network becomes.

Discovery Node

What it does

Search infrastructure for specific content types in your region

Who should run it

Organizations, communities, universities

Requirements

VPS with Docker, Elasticsearch

Schema Registry Node

What it does

Mirror the content type registry for redundancy

Who should run it

Technical organizations, hosting providers

Requirements

VPS with Docker, PostgreSQL

Context Directory Node

What it does

User goals and geo data for your region

Who should run it

Privacy-focused organizations

Requirements

VPS with Docker, PostgreSQL + PostGIS

Tech Stack

BackendNestJS, Prisma, PostgreSQL, Redis, Elasticsearch, BullMQ
FrontendAngular 19, Tailwind CSS, Lucide Icons
MobileIonic, Capacitor, SQLite
InfrastructureDocker, Hetzner Cloud, Caddy/Nginx
AIMistral (European default), optional OpenAI/Claude/Gemini
SearchElasticsearch (BM25 + vector similarity)
GeoPostGIS, ISO 3166-1/2, GeoNames
SecurityEd25519 signing, JWT, Helmet, CORS, rate limiting
i18n24 EU official languages across all components

Why decentralized?

Why not just build a centralized platform?
Centralized platforms create single points of failure, control, and monetization. roadbeat's architecture ensures no single entity can manipulate content ranking, lock in publishers, or surveil users.
Is it really decentralized or just self-hosted?
Both. Each component (Schema Registry, Discovery Nodes, Studio Nodes, Context Directories) can be independently operated by different organizations. They communicate through standardized APIs and signed content - not through a central server.
How is content quality maintained without a central authority?
Content types are governed by expert committees via the Schema Registry. Publishers are verified through a 4-level trust system. Discovery Nodes apply content quality scoring. Users see transparency reasons for every match.
What happens if a Discovery Node goes down?
Content remains available on publisher servers. Other Discovery Nodes continue to serve search results. The network is designed to be resilient - no single node is critical.
How does this compare to the Fediverse?
roadbeat shares the Fediverse's values of decentralization and user control, but goes further by structuring content with 100+ purpose-built types. Instead of flat posts flowing through a social graph, content is matched to user-defined goals through transparent filtersets.