NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Grüne Neon Szene, Frau startet Papierflieger, gelbes Schild ASTROPAPER

Was ist AstroPaper?

AstroPaper ist ein kostenloses Astro Blog Theme mit Fokus auf Barrierefreiheit, Performance und SEO. Du schreibst deine Beiträge in Markdown, AstroPaper macht daraus ein schnelles statisches Blog mit Suche, RSS Feed und Dark Mode.
Gebaut hat das Theme der Entwickler Sat Naing, ursprünglich für sein eigenes Blog. Heute ist AstroPaper eines der bekanntesten freien Themes auf astro.build. Das Repo satnaing/astro-paper hat rund 5.000 Sterne auf GitHub und steht unter MIT Lizenz.
Technisch setzt AstroPaper auf Astro 7, TypeScript und Tailwind CSS 4. Die Suche läuft über Pagefind, die Vorschaubilder für Social Media entstehen beim Build mit Satori.
Inhalt
NCA KI Workshop für Developer

Agentic Coding im Team, nicht nur im Glossar

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.

  1. 1
    Kostenloses Vorgespräch
    Stand, Rollen und Ziele klären
  2. 2
    Workshoptag bei euch
    Praxis am Vormittag, Hands on danach
  3. 3
    Praxistag optional
    Agenten im eigenen Projekt
Benjamin Klein
Benjamin Klein
Senior Consultant
Zum Workshop für Developer arrow_forward

AstroPaper mit NCA richtig einordnen

Never Code Alone arbeitet täglich mit Astro und Tailwind CSS. Wir kennen den Astro Static Site Build und die Astro Islands Architektur aus echten Projekten. AstroPaper selbst nutzen wir nicht produktiv. Wir ordnen das Theme für Teams neutral ein und zeigen, wo es passt.
Dazu gehören ein sauberes Setup mit TypeScript im Strict Mode, eigenes Design mit Tailwind CSS, Inhalte aus Obsidian als CMS für Astro und Tests mit dem NCA TESTIFY Cypress Plugin. Mehr zu unserem Schwerpunkt findest du im Bereich Frontend Development.

Diese Features bringt AstroPaper mit

AstroPaper liefert alles, was ein technisches Blog braucht. Du musst nichts nachrüsten, um zu starten.
  • Typsicheres Markdown: Content Collections prüfen das Frontmatter jedes Beitrags beim Build.
  • Barrierefreiheit: Bedienung per Tastatur, getestet mit VoiceOver auf dem Mac und TalkBack auf Android.
  • Statische Suche: Pagefind baut den Suchindex beim Build, ein externer Suchdienst ist nicht nötig.
  • Light und Dark Mode: umschaltbar, mit vordefinierten Farbschemata.
  • Dynamische OG Bilder: Satori und Sharp erzeugen für jeden Beitrag ein eigenes Vorschaubild.
  • Drafts und Pagination: Entwürfe bleiben unsichtbar, Listen werden automatisch geteilt.
  • Sitemap und RSS: beides entsteht automatisch.
  • MDX: Komponenten direkt im Beitrag.
  • Inhaltsverzeichnis: neben dem Beitrag, einklappbar.
  • Bereit für i18n: Texte der Oberfläche liegen in eigenen Sprachdateien.
Für das Design gibt es eine offene Figma Datei. Damit können Designer das Theme anpassen, bevor jemand eine Zeile Code schreibt.

AstroPaper Steckbrief

Eigenschaft AstroPaper Was das für dich heißt
Lizenz MIT Frei nutzbar, auch für kommerzielle Projekte
Stack Astro 7, TypeScript, Tailwind CSS 4 Aktueller Stand, kein Umbau vor dem Start
Suche Pagefind Läuft statisch, ohne externen Dienst
Social Bilder Satori und Sharp OG Bild pro Beitrag ohne Handarbeit
Konfiguration astro-paper.config.ts Titel, Autor, Features an einer Stelle
GitHub rund 5.000 Sterne, über 1.000 Forks Große Community, viele Beispiele

So startest du ein Blog mit AstroPaper

Der Einstieg dauert wenige Minuten. Das Astro CLI holt das Template direkt von GitHub.
Code:
          

npm create astro@latest -- --template satnaing/astro-paper
cd mein-blog
npm install
npm run dev

Deine Beiträge legst du als Markdown Dateien in src/content/posts/ ab. Unterordner werden Teil der URL. So bleibt auch ein großes Blog übersichtlich.
Code:
          

---
title: Mein erster Beitrag
pubDatetime: 2026-11-18T09:00:00Z
description: Kurzer Teaser für Liste und Suche
tags:
  - astro
draft: false
---

Hier beginnt dein Text.

Der Build erzeugt fertiges HTML im Ordner dist. Wie dieser Ordner aufgebaut ist, zeigt unser Artikel zur dist Ordner Struktur. Wird der Build zäh, hilft der Beitrag Astro Build langsam.

So passt du AstroPaper an deine Marke an

Fast alles steuerst du über eine einzige Datei, die astro-paper.config.ts. Dort stehen Titel, Autor, Sprache und Zeitzone. Auch einzelne Features schaltest du hier an oder aus.
Code:
          

import { defineAstroPaperConfig } from "./src/types/config";

export default defineAstroPaperConfig({
  site: {
    url: "https://dein-blog.de/",
    title: "Dein Blog",
    author: "Dein Name",
    lang: "de",
    timezone: "Europe/Berlin",
  },
  features: {
    lightAndDarkMode: true,
    dynamicOgImage: true,
    search: "pagefind",
    toc: true,
  },
});

Farben passt du über die mitgelieferten Farbschemata oder eigene CSS Variablen an. Weil das Styling auf Tailwind CSS basiert, bleibt der Code für Teams gut lesbar. Achte beim Umbau auf Kontraste und Abstände. Unser Beitrag zu line-height nach WCAG zeigt, worauf es dabei ankommt.

AstroPaper im Vergleich zu Fuwari und Starlight

Unter den freien Themes auf astro.build haben drei Projekte die meisten Sterne auf GitHub. Das sind Starlight, AstroPaper und Fuwari. Sie lösen unterschiedliche Aufgaben. AstroPaper ist das ruhige Blog, Fuwari das verspielte Blog und Astro Starlight das Werkzeug für Dokumentation.

Die drei bekanntesten freien Astro Themes

Theme Stärken Passt für
Starlight (über 9.000 Sterne) Offiziell von Astro, Navigation, Suche, i18n, Komponenten für Doku Technische Dokumentation und Wissensseiten
AstroPaper (rund 5.000 Sterne) Barrierefreiheit, Pagefind, OG Bilder, Astro 7 und Tailwind CSS 4 Technische Blogs und persönliche Websites
Fuwari (rund 5.000 Sterne) Animationen, Themenfarben, Banner, erweitertes Markdown Persönliche Blogs mit starkem Look
Wartung Starlight und AstroPaper werden laufend gepflegt Fuwari hat viele offene Issues und läuft noch auf Astro 5

Diese Grenzen solltest du bei AstroPaper kennen

AstroPaper ist bewusst schlicht. Wer viele Effekte, große Bilder oder eine Landingpage mit Preistabellen sucht, wird hier nicht glücklich. Das Theme ist für Text gemacht.
  • Kein CMS an Bord: Inhalte liegen als Markdown im Repo. Redaktionen ohne Git Kenntnisse brauchen eine Oberfläche dazu.
  • Ein Autor im Fokus: Mehrere Autoren gehen, sind aber nicht der Kern des Designs.
  • Kein Kommentarsystem: Kommentare musst du selbst einbinden.
  • Updates per Git: Neue Versionen holst du über Merges aus dem Original Repo. Eigene Änderungen können dabei Konflikte erzeugen.
Für ein Unternehmensblog mit mehreren Redakteuren lohnt ein Blick auf die Content Strategie. Eine Datenbank mit SQLite und Drizzle oder Markdown aus Obsidian sind zwei Wege, die wir mit Teams durchgehen.

Ein minimales, responsives, barrierefreies und SEO freundliches Astro Blog Theme

Sat Naing, Entwickler und Maintainer von AstroPaper – README von AstroPaper auf GitHub, deutsche Fassung

So ordnet NCA AstroPaper in der Praxis ein

Wir helfen Teams bei der Frage, ob AstroPaper als Basis für ihr Blog taugt. Wir schauen auf den vorhandenen Stack, auf die Menschen, die schreiben sollen, und auf den Aufwand im Betrieb. Wer schon Astro nutzt, findet einen kurzen Weg. Warum Astro auch für den Einstieg gut passt, zeigt Astro Framework für Vibe Coding.
Ein Theme ist ein Startpunkt. Für Production zählen Quality Gates, ein sauberes Deployment und gemessene Ladezeiten mit CrUX Felddaten. Warum sich das lohnt, zeigt die Case Study zu Ladezeit und Umsatz. Für barrierefreie Erweiterungen eignen sich die Accessible Astro Components.
Wenn ein KI Agent beim Umbau mitschreibt, braucht er klare Regeln. Unsere AI Coding Guidelines für TypeScript und die NCA Agentic AI Coding Guardrails geben diesen Rahmen. Im NCA KI Workshop für Developer üben Teams genau das am eigenen Projekt.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.
Frontend: Optimieren Sie Ihre Webseite mit Astro JS und nutzen Sie die Vorteile der Barrierefreiheit

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.

Häufige Fragen zu AstroPaper

Hier findest du kurze Antworten auf die Fragen, die Teams zu AstroPaper am häufigsten stellen.
Ist AstroPaper 2026 noch aktuell?

Ja. AstroPaper läuft auf Astro 7, TypeScript und Tailwind CSS 4 und wird laufend gepflegt. Der Maintainer Sat Naing zieht neue Astro Versionen zügig nach. Damit startest du ohne Umbau auf einem aktuellen Stand. Prüfe vor dem Start trotzdem die offenen Issues im Repo, damit du bekannte Stolpersteine kennst.

Ist AstroPaper 2026 wirklich kostenlos?

Ja. AstroPaper steht unter MIT Lizenz. Du darfst das Theme frei nutzen, verändern und auch für kommerzielle Projekte einsetzen. Pflicht ist nur, den Lizenzhinweis im Code zu behalten. Kosten entstehen höchstens für dein Hosting und die Zeit, die du in Anpassungen steckst.

Wie viele GitHub Sterne hat AstroPaper 2026?

AstroPaper hat rund 5.000 Sterne und über 1.000 Forks auf GitHub. Damit gehört es zu den drei bekanntesten freien Themes auf astro.build. Mehr Sterne hat dort nur Starlight, das offizielle Doku Werkzeug von Astro. Fuwari liegt bei den Sternen etwa gleichauf mit AstroPaper.

Welche Astro Version nutzt AstroPaper 2026?

AstroPaper nutzt Astro 7 zusammen mit Tailwind CSS 4. Für MDX, RSS und Sitemap kommen die offiziellen Astro Integrationen zum Einsatz. Die Suche läuft über Pagefind, OG Bilder entstehen mit Satori. Das Setup passt damit gut zu modernen Astro Projekten und zu aktuellen Node Versionen.

Ist AstroPaper 2026 barrierefrei?

AstroPaper legt großen Wert auf Barrierefreiheit. Die Bedienung per Tastatur funktioniert, und der Maintainer hat das Theme mit VoiceOver und TalkBack getestet. Das ist eine gute Basis, ersetzt aber keine Prüfung deiner eigenen Inhalte. Farben, Bilder ohne Alt Text oder eigene Komponenten können neue Barrieren erzeugen.

Wie funktioniert die Suche in AstroPaper?

AstroPaper nutzt Pagefind. Pagefind baut den Suchindex beim Build und legt ihn als statische Dateien neben dein Blog. Im Browser lädt die Suche nur die Teile des Index, die sie gerade braucht. Du brauchst dafür keinen Server und keinen externen Suchdienst.

Kann ich AstroPaper auf Deutsch betreiben?

Ja. AstroPaper ist für i18n vorbereitet. Die Texte der Oberfläche liegen in eigenen Sprachdateien. In der Konfiguration stellst du Sprache und Zeitzone ein, zum Beispiel de und Europe/Berlin. Deine Beiträge schreibst du ohnehin selbst in Markdown, also in der Sprache deiner Wahl.

Wie entstehen die OG Bilder in AstroPaper?

AstroPaper erzeugt beim Build für jeden Beitrag ein eigenes Vorschaubild. Dafür kombiniert das Theme Satori, Sharp und Astro Fonts. Titel und Autor landen automatisch im Bild. Willst du ein eigenes Bild, setzt du im Frontmatter das Feld ogImage. Die Funktion lässt sich in der Konfiguration auch abschalten.

Eignet sich AstroPaper für ein Firmenblog?

AstroPaper eignet sich gut für ein technisches Firmenblog mit wenigen Autoren. Für große Redaktionen fehlt eine Oberfläche, weil Inhalte als Markdown im Repo liegen. Das lässt sich mit einem Headless CMS oder Obsidian als Editor lösen. Für Marketing Seiten mit Preistabellen ist das Theme zu schlicht.

Wie aktualisiere ich AstroPaper später?

Updates holst du über Git aus dem Original Repo. Am einfachsten richtest du das Original als zweites Remote ein und mergst neue Versionen. Je mehr du am Kern änderst, desto mehr Konflikte entstehen dabei. Lege eigene Komponenten deshalb möglichst getrennt ab und halte Änderungen an Original Dateien klein.

Was ist der Unterschied zwischen AstroPaper und Fuwari?

AstroPaper ist schlicht, schnell und auf Lesbarkeit getrimmt. Fuwari setzt auf Animationen, Seitenübergänge, Banner und frei wählbare Themenfarben. AstroPaper läuft auf Astro 7, Fuwari noch auf Astro 5. Wer ein ruhiges Blog für Fachartikel sucht, greift eher zu AstroPaper. Wer einen starken Look will, schaut sich Fuwari an.

Wann ist Starlight besser als AstroPaper?

Starlight ist besser, wenn du Dokumentation baust. Es bringt Seitennavigation, Hinweisboxen, Komponenten wie Tabs und Steps und eine Struktur für viele verschachtelte Seiten mit. AstroPaper ist für Beiträge gemacht, die nach Datum und Tags sortiert sind. Viele Teams kombinieren beides, Blog mit AstroPaper und Doku mit Starlight.