Add “Building a federated blog” tutorial (Astro + Bun + SQLite)

.gitignore

@@ -17,3 +17,4 @@ t.ts
 t2.ts
 plan.md
 plans/
+.playwright-mcp/

.hongdown.toml

@@ -40,6 +40,7 @@ proper_nouns = [
   "ActivityPub",
   "ActivityStreams",
   "Akkoma",
+  "bun-types",
   "BotKit",
   "BrowserPub",
   "Cloudflare Workers",

CHANGES.md

@@ -124,6 +124,21 @@ To be released.
 [#656]: https://github.com/fedify-dev/fedify/pull/656
 [#675]: https://github.com/fedify-dev/fedify/pull/675
 
+### Docs
+
+ -  Added [*Building a federated blog* tutorial] showing how to layer
+    ActivityPub federation onto an [Astro] + [Bun] blog: actor setup,
+    follower management, SQLite persistence, sending `Create`/`Update`/
+    `Delete(Article)` activities on server startup, and receiving
+    `Create`/`Update`/`Delete(Note)` inbox activities as comments.
+    [[#691], [#695]]
+
+[*Building a federated blog* tutorial]: https://fedify.dev/tutorial/astro-blog
+[Astro]: https://astro.build/
+[Bun]: https://bun.sh/
+[#691]: https://github.com/fedify-dev/fedify/issues/691
+[#695]: https://github.com/fedify-dev/fedify/pull/695
+
 
 Version 2.1.5
 -------------
@@ -420,7 +435,6 @@ Released on March 24, 2026.
     runtime-specific templates for Deno, Bun, and Node.js environments.
     [[#50] by ChanHaeng Lee]
 
-[Astro]: https://astro.build/
 [#50]: https://github.com/fedify-dev/fedify/issues/50
 
 ### @fedify/astro

deno.json

@@ -100,7 +100,8 @@
     "exclude": [
       "**/*.html",
       "**/*.md",
-      "**/*.svg"
+      "**/*.svg",
+      ".playwright-mcp/**"
     ]
   },
   "nodeModulesDir": "auto",

docs/.vitepress/config.mts

@@ -95,6 +95,7 @@ const TUTORIAL = {
     },
     { text: "Learning the basics", link: "/tutorial/basics.md" },
     { text: "Creating a microblog", link: "/tutorial/microblog.md" },
+    { text: "Building a federated blog", link: "/tutorial/astro-blog.md" },
   ],
   activeMatch: "/tutorial",
 };