Fullstack Decentralised
CHEATSHEET
Front
What is Swarm? tl;dr
Fullstack Decentralised

Swarm is a decentralised storage and communication network run by peer-to-peer Bee nodes. Upload data, get back a content hash — a permanent address derived from the bytes themselves. Anyone with the hash can retrieve the content from any Bee node or public gateway.

Storage is bought as postage stamps: prepaid batches purchased with xBZZ on Gnosis Chain. Batches have a TTL and expire unless topped up. If every batch covering a chunk expires, that content can be pruned.

What you can build on Swarm
Build with freedom · No servers, no gatekeepers

# File & media storage

Fixed, content-addressed URLs for any file — images, video, PDFs, datasets, ML artifacts, NFT assets.

# Decentralised websites

Publish a static front-end straight to the network. No server, no CDN, no DNS lock-in.

# Blogs & dashboards

Stable URLs whose contents update via feeds. Personal blogs, public dashboards, status pages.

# Live video & streaming

Early proof-of-concept work on HLS over Swarm exists — expect to integrate and tune it yourself.

# Chat, comments & messaging

Real-time chat, threaded comments and peer messaging. Real-time delivery needs a GSOC subscription (see back).

# dApp front-ends

Host a static front-end for an Ethereum dApp on Swarm. On-chain contracts with content-addressed UI for a fully decentralised stack.

What Swarm is  not
  • Not a database. Opaque blobs addressed by hash — no queries, no indexing, no search. Model structure in the app layer.
  • Not permanent without payment. Content lives only while a valid postage stamp covers its chunks.
  • Not instantly consistent. Uploads propagate asynchronously. deferred:true (default) returns once data is pushed; deferred:false waits for read-back.
  • Not free to write. Every upload needs a funded light node and a stamp paid in xBZZ. Reads have a small free tier on gateways.
  • Not a smart-contract platform. It stores data, it does not execute code. Complements Ethereum, does not replace it.
Limitations & gotchas
  • Stamp batch expiry. Past expiry, chunks become eligible for pruning — not deleted instantly, but can vanish. Monitor and top up.
  • Dynamic pricing. Stamp cost tracks a price that can rise — top up so batches outlast your needs.
  • Feed writes are append-only. Each index slot writes once; always resolve the current index before writing.
  • Feed slots hold ≤ 4 KB. For larger payloads, upload as a file first, then write the reference into the feed.
  • The public gateway blocks unreviewed sites. A fresh upload can show "Forbidden" — view it at bzz.limo/bzz/<hash>/ or via your own node.
  • Capacity & lifetime are non-deterministic. Both depend on chunking and dynamic pricing — monitor and top up.

START BUILDING ON SWARM

Three ways in · pick your path
No install · in the browser
Upload via Beeport
Buy a stamp with any token and upload files or a whole site through Beeport's hosted gateway nodes — nothing to run, no node of your own.
Good for a first upload & quick demos; run a node when you want your own infrastructure.
Your own node · Linux / macOS / WSL
Run a Bee light node
$ curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash
$ npm i -g @ethersphere/swarm-cli # Node ≥ 18
Fund the node ↓ then buy a stamp — full steps: /bee/installation/quick-start
No funds? Bee Factory runs a local dev cluster with free stamps (Docker): /.../bee-dev-mode
Optional · AI-assisted
Guided setup with Claude Code
$ curl -fsSL https://claude.ai/install.sh | bash
$ git clone https://github.com/ethersphere/swarm-quickstart-skills.git $ cd swarm-quickstart-skills && claude
Type /swarm — guided node setup, stamps, upload, hosting. Stuck? /swarm-troubleshoot. Windows: code.claude.com/docs

Fund your node → fund.ethswarm.org

A node without funds won't run. Top it up on Gnosis from any EVM chain, any token — one transaction.

Deploy a website → justdeploy.bzz.link

Guided deploy walkthrough — Browser · Desktop app · CLI. Mirror: justdeploy.eth.limo

▸ More on the back: developer URLs, examples, network tools, community ▸
Swarm · Cheatsheet / Frontv1 · ethswarm.org
Fullstack Decentralised
BUILD LINKS
Back
Where to go next scan by category · all links stay updated online
Swarm Developer Resources

docs.ethswarm.org/docs/develop/resources

One curated landing page linking every category below. Bookmark it — links stay updated online, so this printed sheet keeps working.

Examples

Publishing & Websites

static sites, blogs, file uploads
Scan QR → more publishing examples
Tools

Claude Code + Skills

AI-assisted dev · optional
Scan QR → skills repo
Learn
Community & Support
Swarm · Build Links / Back · print A4 double-sidedVerified: Bee 2.8.1 · bee-js 12.x · swarm-cli 3.x