Astro Starlight erklärt, Setup, Plugins, Grenzen und der Vergleich mit Docusaurus, VitePress und GitBook für technische Dokumentation.
Mehr erfahren
Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.
pnpm new-post legt die Datei mit Frontmatter an.
---
title: Mein erster Beitrag
published: 2026-11-18
description: Kurzer Teaser für Liste und Suche
image: ./cover.jpg
tags: [Astro, Blog]
category: Frontend
draft: false
---
pnpm create fuwari@latest
cd mein-blog
pnpm install
pnpm dev
src/config.ts. Dort setzt du Titel, Sprache, Themenfarbe und Banner. Den Farbton gibst du als Wert zwischen 0 und 360 an.
export const siteConfig: SiteConfig = {
title: "Mein Blog",
subtitle: "Notizen aus dem Code",
lang: "de",
themeColor: {
hue: 150,
fixed: true,
},
banner: {
enable: true,
src: "assets/images/banner.png",
position: "center",
},
};
pnpm new-post mein-beitrag an. Vor dem Deployment trägst du in der astro.config.mjs deine Domain ein. Wird der Build zäh, hilft der Beitrag Astro Build langsam.
Ein statisches Blog Template, gebaut mit Astro
Astro Starlight erklärt, Setup, Plugins, Grenzen und der Vergleich mit Docusaurus, VitePress und GitBook für technische Dokumentation.
Mehr erfahren
Wir bauen schnelle, sichere und barrierefreie Websites mit Astro. Kurze Ladezeiten, saubere Technik und gute Bedienbarkeit für alle, so erfüllt eure Website die gesetzlichen Anforderungen und wird gleichzeitig besser gefunden. Jede Änderung prüfen automatisierte Tests, bevor sie live geht.
Nur eingeschränkt. Das Original läuft noch auf Astro 5 und Tailwind CSS 3, während Astro 7 und Tailwind CSS 4 aktuell sind. Im Repo liegen viele offene Issues und Pull Requests. Das Template funktioniert, für ein neues Projekt solltest du aber ein Update auf den aktuellen Stack einplanen.
Ja. Fuwari steht unter MIT Lizenz. Du darfst das Template frei nutzen, verändern und auch kommerziell einsetzen. Den Lizenzhinweis im Code musst du behalten. Kosten entstehen nur für dein Hosting und für die Zeit, die du in Anpassungen und Updates steckst.
Fuwari hat rund 5.000 Sterne und über 1.000 Forks auf GitHub. Damit liegt es etwa gleichauf mit AstroPaper. Unter den freien Themes auf astro.build hat nur Starlight deutlich mehr Sterne. Viele Forks sind eigene Ableger, zum Beispiel Mizuki, die Fuwari weiterentwickeln.
Das Original Repo nutzt Astro 5 mit Tailwind CSS 3 und Svelte 5. Für Seitenübergänge kommt Swup zum Einsatz, für Code Blöcke Expressive Code. Ein Wechsel auf Astro 7 ist möglich, betrifft aber Konfiguration, Integrationen und das Tailwind Setup. Plane dafür Tests und etwas Zeit ein.
Fuwari eignet sich für persönliche Blogs, bei denen der Look zählt. Wer Animationen, ein großes Banner und eigene Farben mag, wird hier schnell glücklich. Für Firmenblogs mit langem Betrieb ist der Wartungsstand ein Risiko. Dort passt ein laufend gepflegtes Theme wie AstroPaper meist besser.
Die Farben steuerst du über einen einzigen Farbton in der Datei src/config.ts. Der Wert liegt zwischen 0 und 360. Fuwari berechnet daraus das ganze Farbschema. Mit fixed auf true blendest du die Farbauswahl für Besucher aus. So bleibt dein Blog in deiner Markenfarbe.
Fuwari bringt Admonitions als farbige Hinweisboxen, GitHub Repo Karten und erweiterte Code Blöcke mit Expressive Code mit. Dazu kommt Mathe Satz mit KaTeX. Alles schreibst du direkt in Markdown, ohne eigene Komponenten zu bauen. Das spart viel Zeit bei technischen Beiträgen.
Fuwari nutzt Pagefind. Der Suchindex entsteht beim Build und liegt als statische Dateien neben deinem Blog. Im Browser lädt die Suche nur die Teile, die sie braucht. Du brauchst weder einen Server noch einen externen Suchdienst. Die Suche funktioniert deshalb auch auf einfachem Static Hosting.
Ja. In der Datei src/config.ts stellst du die Sprache über lang ein, zum Beispiel de. Pro Beitrag kannst du im Frontmatter eine abweichende Sprache setzen. Die README gibt es in mehreren Sprachen, eine deutsche Fassung fehlt bisher. Deine Inhalte schreibst du ohnehin selbst in Markdown.
Fuwari ist ein statisches Blog und damit grundsätzlich schnell. Animationen, Swup und Svelte bringen aber mehr JavaScript in den Browser als ein schlichtes Theme. Große Banner Bilder belasten die Ladezeit zusätzlich. Miss deshalb mit echten Felddaten und optimiere Bilder, bevor du live gehst.
Fuwari setzt auf Effekte, Banner und frei wählbare Farben. AstroPaper ist schlicht, auf Lesbarkeit und Barrierefreiheit getrimmt. AstroPaper läuft bereits auf Astro 7 und wird laufend gepflegt, Fuwari noch auf Astro 5. Für einen starken Look passt Fuwari, für einen ruhigen Fachblog eher AstroPaper.
Mizuki ist ein Blog Template, das auf Fuwari basiert und ebenfalls auf astro.build gelistet ist. Es ergänzt Sonderseiten wie Tagebuch, Fotoalben, Projekte und Zeitleiste. Mizuki zeigt, wie viele Ableger Fuwari hat. Prüfe bei jedem Fork Lizenz, Pflege und Astro Version, bevor du darauf aufbaust.