Blogartikel schreiben

Einrichtung und Konfiguration

Lesen Sie vor jedem Schritt Bevor Sie beginnen und Terminal-Grundlagen. Bei diesen Anweisungen wird davon ausgegangen, dass Sie das vollständige Supastack-Monorepo in VS Code geöffnet haben. Sein Stamm package.json markiert den Repository-Stamm. In pnpm-Befehlen ist ein Arbeitsbereichspaket eine App oder ein Ordner mit gemeinsam genutztem Code. Im Produkt ist ein Arbeitsbereich der Datencontainer und die Sicherheitsgrenze eines Teams. corepack pnpm --filter ... wählt ein Paket aus dem Monorepo aus, während Befehle von seinem Stammverzeichnis aus ausgeführt werden. Wenn Sie nur einen synchronisierten Mobil- oder Desktop-Ordner geöffnet haben, enthält dieser weder das Web-Backend, Docker-Setup noch Root-Skripte: Führen Sie das Backend von diesem Monorepo oder einem erreichbaren gehosteten Server aus und verwenden Sie die eigenen Skripte des Plattformordners. Eine Umgebungsvariable ist eine benannte Einstellung, die in einer lokalen .env-Datei oder Ihrem Hosting-Dashboard gespeichert ist; Starten Sie die entsprechende App neu, nachdem Sie sie geändert haben, und halten Sie Servergeheimnisse von den Werten NEXT_PUBLIC_ und EXPO_PUBLIC_ fern.

1. Öffnen Sie in VS Code apps/web/src/resources/content.ts und kopieren Sie einen vollständigen Artikel in der Nähe als Ausgangspunkt. Die Artikelkopie befindet sich im Repository und nicht in einem Veröffentlichungs-Dashboard.

2. Geben Sie dem Artikel einen neuen Slug, Titel, Kategorie, Datum, Abschnitte und einen vorhandenen Guide-Slug.

3. Führen Sie im Repository-Root den Befehl „corepack pnpm --filter @supastack/web dev“ aus und öffnen Sie http://localhost:3000/blog/<your-slug>.. Erwartet: Der Artikel und sein Link zum zugehörigen Leitfaden werden lokal geladen, bevor Sie URL freigeben.

Blog-Inhalte liegen in src/resources/content.ts und blog-posts.ts. Sie werden im Repository verwaltet; es gibt keinen CMS-Publishing-Dienst. Jeder Post benötigt einen eindeutigen Slug, Titel, Beschreibung, Kategorie, ein Datum, einen passenden Guide und Abschnitte.

{
  slug: 'your-article',
  title: 'A specific reader question',
  category: 'Guides',
  date: '2026-09-07',
  guide: 'web/local-setup',
  sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}

Befehle zum Kopieren

Befolgen Sie die Kommentare, um zu sehen, in welchem Ordner ein Befehl ausgeführt wird. Wenn zwei Terminals gekennzeichnet sind, öffnen Sie zwei Terminalfenster und lassen Sie den ersten Befehl laufen, während Sie den zweiten verwenden.

corepack pnpm --filter @supastack/web dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.ts

Implementierungsablauf

Orientiere dich bei den übrigen Pflichtfeldern an einem vollständigen vorhandenen Post-Objekt. Lass den Slug nach der Veröffentlichung stabil, damit geteilte URLs weiterhin funktionieren. Überschriften brauchen eindeutige Abschnitts-IDs für Inhaltsverzeichnis und Ankerlinks.

Kategorien werden aus dem Artikelkatalog abgeleitet. Der Index filtert anhand der URL, und die Artikelrouten erzeugen Metadaten aus den Inhalten. Der Guide-Wert muss einem vorhandenen Dokumentations-Slug entsprechen; verwandte Inhalte sollten einen sinnvollen nächsten Schritt bieten.

Überprüfung und Fehlerbehebung

Liefert der Artikel 404, prüfen Sie, ob sein Slug eindeutig ist und er in der Artikelliste in apps/web/src/resources/content.ts steht. Springt das Inhaltsverzeichnis ins Leere, vergeben Sie jedem Abschnitt eine eindeutige id. Führen Sie im Stammverzeichnis corepack pnpm test -- apps/web/src/resources/content.test.ts aus, um Inhaltsfehler zu sehen.

Führe die Inhaltstests aus, öffne die Artikelroute, folge dem zugehörigen Guide und prüfe den gefilterten Index. Prüfe Daten und Aussagen anhand des Quellenmaterials. Veröffentliche keine Platzhalter-Links und behaupte nicht, eine Integration sei verifiziert, nur weil sie in einem Artikel erwähnt wird.