TypeScript · ActivityPub · Open source
+
+ Build for the
+ fediverse,
+ skip the boilerplate.
+
+ + Fedify is a TypeScript framework that handles + federation, signatures, discovery, activity vocabulary, and delivery + behind type-safe APIs, so you ship features, not specs. It's modular, + too: adopt the whole thing or just the parts you need, and it never + dictates how your app is built. +
+ +{{ activeCmd }}
+
+ 
+ What's Fedify?
++ A federation framework, not just a protocol library. +
++ The fediverse is millions of accounts spread across thousands of + independent servers, all talking through shared protocols. Implementing + those protocols by hand is a lot of subtle, security-critical work. + Fedify handles all of it, actors and activity vocabulary, signatures, + discovery, and queued delivery, so a post on your server reaches + Mastodon, Misskey, Lemmy, and the rest, correctly and securely. It's + that broad, yet modular: take only the pieces you need, and it won't + decide how the rest of your app is structured. +
+ Read the full introduction → +Why Fedify?
+Federation is a stack of specs. Fedify implements it.
++ Going federated means getting a whole pile of standards right, and + keeping them right as they evolve. Fedify implements them so you + don't have to, and exposes them through one coherent, typed API. +
+ See the full rationale → +-
+
- + + {{ s.name }} + {{ s.name }} + {{ s.spec }} + + +
Looks like this
+Define an actor. Fedify handles the wire.
++ Map a route to a typed actor and you get a working, discoverable, + cryptographically-signed ActivityPub endpoint, no manual JSON-LD, no + signature plumbing. +
+ Follow the tutorial → +Type-safe vocabulary
+Type-safe objects, no JSON-LD headaches
++ Fedify models the whole Activity Vocabulary as immutable, type-safe + objects, backed by a real JSON-LD processor and exposed as a fully + typed API. +
+-
+
- + + + {{ p.term }} + + + +
Reliable at scale
+Reliable delivery, even to huge audiences
++ Outgoing activities go through a message queue, so a flaky recipient + never costs you a post. For large audiences, a two-stage fan-out + returns instantly and delivers to every inbox in the background. +
+{{ p.title }}
+{{ p.desc }}
+Run the queue on the broker you prefer
+-
+
- + + + + +
- and more +
Works with your stack
+Drops into the web framework you already use
+
+ Fedify doesn't take over your app. It runs as middleware on the
+ domain and port you already have, using content negotiation to pick
+ out federation traffic and leaving the rest of your routes alone.
+ First-party packages cover the frameworks below, and
+ fedify init scaffolds a project for you.
+
-
+
- + + + + +
- and more +
No official package? No problem.
+
+ Fedify is built on the web-standard
+ Request and
+ Response, so dropping it into anything with
+ middleware takes about a dozen lines.
+
Your data, your schema
+Fedify never owns your data model
+
+ Your actors, posts, and followers live in your own database, in
+ whatever schema you already have. Fedify reads them through dispatcher
+ callbacks you write, so the data model stays yours. For its own
+ internal state, a cache and some federation bookkeeping, it relies on a
+ pluggable KvStore: keep it in memory while you develop, or
+ back it with Redis, PostgreSQL, MySQL, SQLite, Deno KV, or Cloudflare
+ Workers KV.
+
Plays well with others
+Interoperates with the software people already use
+-
+
- + + + + +
- and more +
Developer tooling
+A toolchain for building and debugging
+
+ The fedify command-line tool turns the fiddly parts of
+ ActivityPub development into one-liners, from inspecting remote
+ objects to watching exactly what your own server sends. Alongside it,
+ @fedify/lint catches common federation mistakes as
+ you write, and
+ @fedify/debugger adds a live
+ dashboard of inbox and outbox activity.
+
-
+
-
+
+
{{ c.cmd }}+ + {{ c.desc }} +
+
Built for production
+See exactly what your server is doing
++ Fedify is instrumented with OpenTelemetry out of the box, so the + whole federation lifecycle shows up as traces and metrics in the + observability stack you already run. +
+-
+
- + + + {{ p.term }} + {{ p.desc }} + + +
ActivityPub API
+Accept posts straight from your clients
+
+ The ActivityPub API, the client-to-server (C2S) side of the
+ protocol, is something of a holy grail in the fediverse, and Fedify
+ is ready for it. Route POST requests to an actor's
+ outbox through typed listeners and authorize them however you like.
+
-
+
- + + + {{ p.term }} + + + +
Ready to join the fediverse?
++ Install Fedify and have a federated actor running in minutes. +
+ ++ Need a hand? Ask the community on + GitHub Discussions + or + Matrix, or tag + #Fedify + in the fediverse. +
++ Fedify is free and open source. + Meet our sponsors → +
+
+ Also from the Fedify team:
+
+ {{ p.name }}
+
+
Backed by an investment from
+ + + +