rb
roadbeat
Back to How It Works

Schema Registry

The DNA of structured content.

Every piece of content in roadbeat has a defined structure. The Schema Registry stores, versions, and distributes these definitions across the entire ecosystem.

What are structured content types?

Unlike traditional social media where everything is a flat "post", roadbeat defines purpose-built content types - each with specific fields, validation rules, and metadata. An Event has dates and a location. A Recipe has ingredients and cooking steps. A Job has salary and requirements.

  • Rich, queryable metadata enables precise discovery
  • Consistent structure across all publishers
  • Type-specific form UIs in Studio for easy authoring
  • Machine-readable schemas enable automated processing

Content Type Gallery

Browse 100+ content types across 14 categories - from News and Events to Recipes, Jobs, and Scientific Papers.

Browse all content types on schemas.roadbeat.net

JSON Schema under the hood

Each content type is defined as a standard JSON Schema with extensions for UI rendering, i18n labels, and teaser generation. Schemas are version-controlled and signed with Ed25519.

Version control

Every schema change creates a new version. Publishers can pin to specific versions for stability.

i18n labels

Field labels and descriptions in all 24 EU official languages, enabling localized form UIs.

Form schemas

UI hints for Studio editors - field order, grouping, validation messages, conditional visibility.

Teaser schemas

Define which fields appear in teasers published to Discovery Nodes.

Governance

The Schema Registry is governed by roadbeat e.V. (eingetragener Verein), a registered German association. Content type proposals go through expert committees, public review, and versioned approval.

1

Community or expert proposes new content type

2

Public review period with feedback

3

Expert committee evaluates and refines

4

Approved schemas are signed and distributed

Tech Stack: NestJS, Prisma, PostgreSQL, Redis, Next.js, Tailwind

License: AGPL 3.0

Explore the Schema Registry

Browse content types, read schema documentation, and propose new types.

Visit schemas.roadbeat.net

Schema Registry Documentation

Dive deeper into content type definitions, schema versioning, governance processes, and the API. Our comprehensive documentation covers everything you need to integrate with the Schema Registry.

Read the Documentation