Developer docs

Documented against main @ bbedf98 (0.8.9-dev, 4 November 2026) · latest release v0.8.8

Demos

Demos

Real apps to read, run and copy from, tagged with the APIs they use. All of them are open source.

On this page

Each demo carries badges for the Freedom APIs it uses, so you can jump straight to the ones that match what you are building. The Swarm and Radicle hubs link back here for their demos.

Demo Kind Uses
Canopy App rad: fetch, window.radicle
Swarmit App window.swarm, window.ethereum
Freedom Community App window.swarm, GSOC
swarm-kit examples Example pages window.swarm via swarm-kit

Apps#

Canopy

A GitHub-style forge for the Radicle network, served from Swarm and powered entirely by the user's own node. Reads repositories, issues and patches with rad: URLs and writes issues and comments with window.radicle.

rad: fetch window.radicle

Swarmit

Discussion boards on Swarm. Posts are immutable Swarm content announced on Gnosis Chain; curators index submissions and publish board and thread views as feeds, and readers pick their curator.

window.swarm window.ethereum

Freedom Community

Communities on Swarm: a protocol, a reference steward and node deployment for Freedom Browser. Members write to their own feeds; the steward is woken by a GSOC doorbell.

window.swarm GSOC

swarm-kit examples#

The swarm-kit repository ships four example pages, each a single index.html plus the library bundle. Run them with the npm run dev:* commands in the guide, or upload a folder to Swarm.

window.swarm swarm-kit

Example What it shows
chat Rooms with durable history in a multi-writer feed, live delivery over GSOC (kit.live.bus, kit.live.multiWriterFeed) and encrypted direct messages over PSS (kit.live.inbox)
epoch-feed-smoke The playground: a tab each for epoch feeds, objects, encryption, signed documents, records, DID documents, hash chains, multi-writer feeds, lookup and commit-reveal
provider-compliance Contract checks against the real window.swarm
test-center Black-box diagnostics for Freedom Browser Swarm providers

Snippets in these docs#

Ecosystem tooling#

These tools work with Swarm and Radicle data directly rather than through Freedom's page APIs, so they are useful next to your app rather than as templates for it.

Project What it is
radicle-index-service Indexes the Radicle network and publishes a signed, user-selectable index to Swarm
dscan A single-file Swarm reference scanner: classify references, browse manifests and feeds, check chunk health. It reads from a Swarm gateway
FreeMap A viewer for OpenStreetMap tiles hosted on Swarm, live at bzz://freemap.eth/

Add your demo#

This page grows with what people build. Built something on window.swarm, window.radicle or rad: URLs? Tell us in the community and we may add it here.