Migration guide from other JavaScript ActivityPub libraries

.hongdown.toml

@@ -37,6 +37,7 @@ proper_nouns = [
   "@fedify/webfinger",
   "Activity Streams",
   "Activity Vocabulary",
+  "ActivityKit",
   "ActivityPub",
   "ActivityStreams",
   "Akkoma",

docs/.vitepress/config.mts

@@ -63,7 +63,10 @@ function getReferenceItems(): { text: string; link: string }[] {
   const names = new Set<string>();
   for (const workspaceEntry of rootDenoConfig.workspace ?? []) {
     if (!workspaceEntry.startsWith("./packages/")) continue;
-    const packageDenoJsonUrl = new URL(`${workspaceEntry}/deno.json`, repoRootUrl);
+    const packageDenoJsonUrl = new URL(
+      `${workspaceEntry}/deno.json`,
+      repoRootUrl,
+    );
     const packageDenoConfig = JSON.parse(
       readFileSync(packageDenoJsonUrl, "utf-8"),
     ) as PackageDenoConfig;
@@ -121,6 +124,7 @@ const MANUAL = {
     { text: "Key–value store", link: "/manual/kv.md" },
     { text: "Message queue", link: "/manual/mq.md" },
     { text: "Integration", link: "/manual/integration.md" },
+    { text: "Migration", link: "/manual/migrate.md" },
     { text: "Relay", link: "/manual/relay.md" },
     { text: "Testing", link: "/manual/test.md" },
     { text: "Debugging", link: "/manual/debug.md" },

docs/install.md

@@ -96,6 +96,12 @@ bunx @fedify/create your-project-dir
 This works the same way as `fedify init` and will guide you through the same
 project setup wizard.
 
+> [!TIP]
+> Already running a federated service on another JavaScript ActivityPub
+> library?  See [*Migrating from other libraries*](./manual/migrate.md) for
+> guides covering `activitypub-express`, `@activity-kit/*`, hand-rolled
+> Express code, and `activitystrea.ms`.
+
 
 Manual installation
 -------------------