Communitygithub.com

Astro Website Builder

Umfassende Fähigkeit zur Erstellung von Websites mit Astro.build. Verwenden Sie diese, wenn ein Benutzer eine Website mit Astro erstellen möchte, ein passendes Thema aus Astros kostenloser Themensammlung auswählen muss, Zugriff auf die Astro-Dokumentation benötigt oder Astro-Komponenten und -Seiten entwickeln möchte. Diese Fähigkeit behandelt Themenauswahl, Dokumentationszugriff, Projekteinrichtung und Astro-spezifische Entwicklungspattern.

Was ist Astro Website Builder?

Diese Fähigkeit namens 'Astro Website Builder' ist ein spezialisiertes Tool für die Entwicklung von Websites mit dem Astro-Framework. Sie führt Entwickler durch den gesamten Workflow: Anforderungsanalyse, Auswahl eines passenden kostenlosen Themes aus der Astro-Sammlung (besonders solche, die mit React kompatibel sind), Projekteinrichtung mit der Create-Astro-CLI sowie Entwicklung von Komponenten und Seiten in Astro. Dabei wird auf die Integrationsdokumentation (entweder mitgelieferte Referenzen für Basiswissen oder die ausführliche LLM-Dokumentation von docs.astro.build) zurückgegriffen. Besondere Schwerpunkte liegen auf der 'Islands-Architektur' – Komponenten sind standardmäßig statisch und Interaktivität wird nur bei Bedarf hinzugefügt – sowie der Typensicherheit durch TypeScript. Die Fähigkeit unterstützt die gängigsten Website-Typen wie Blogs, Portfolios, Dokumentationsseiten, Landing Pages und E-Commerce-Seiten und bietet Best Practices für Performance-Optimierung und Fehlerbehebung. Sie ist plattformunabhängig einsetzbar und funktioniert mit jedem Astro-Projekt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GanderBite/relay/tree/HEAD/.claude/skills/astro-builder

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Astro Website Builder?

Diese Fähigkeit hilft Ihnen, Websites mit Astro.build zu erstellen, indem sie Sie durch Themenauswahl, Dokumentationszugriff und bewährte Entwicklungspraktiken führt. Verwenden Sie diese Fähigkeit, wann immer ein Benutzer die Erstellung mit Astro erwähnt, eine Website erstellen möchte oder Hilfe bei Astro-spezifischen Funktionen benötigt.

Wann Sie Diese Fähigkeit Verwenden Sollten

Aktivieren Sie diese Fähigkeit, wenn:

  • Der Benutzer „Astro“ oder „astro.build“ in seiner Anfrage erwähnt
  • Der Benutzer eine Website erstellen möchte und Astro geeignet wäre (Blogs, Dokumentationen, Portfolios, Marketingseiten usw.)
  • Der Benutzer ein Thema für sein Astro-Projekt auswählen muss
  • Der Benutzer Hilfe bei Astro-Komponenten, Routing oder Konfiguration benötigt
  • Der Benutzer React, Vue oder andere Frameworks mit Astro integrieren möchte
  • Der Benutzer Zugriff auf die Astro-Dokumentation oder bewährte Praktiken benötigt

Arbeitsablauf – Übersicht

Wenn Sie eine Astro-Website erstellen, befolgen Sie diesen Prozess:

  1. Anforderungen verstehen – Bestimmen Sie die Art der Website und die benötigten Funktionen
  2. Passendes Thema auswählen – Wählen Sie aus Astros kostenlosen Themen basierend auf den Anforderungen aus
  3. Dokumentation einsehen – Ziehen Sie die Astro-Dokumentation für bestimmte Funktionen zu Rate
  4. Projekt initialisieren – Richten Sie die Projektstruktur ein
  5. Komponenten entwickeln – Erstellen Sie mit Astros Komponentenarchitektur
  6. Optimieren und bereitstellen – Befolgen Sie bewährte Praktiken für die Leistung

Schritt 1: Anforderungen verstehen

Identifizieren Sie zunächst die Art der Website und ihre Anforderungen:

Website-Typen:

  • Blog-/Veröffentlichungsseite
  • Portfolio/Präsentation
  • Dokumentationsseite
  • Marketing-/Landingpage
  • E-Commerce-Seite
  • Unternehmens-/Geschäftsseite
  • Persönliche Website

Wichtige Fragen:

  • Was ist der Hauptzweck der Seite?
  • Welche Inhaltstypen wird es geben? (Blogbeiträge, Projekte, Produkte usw.)
  • Benötigt sie Interaktivität? (Formulare, Suche, dynamische Inhalte)
  • Welche Frameworks bevorzugt der Benutzer? (React, Vue, Svelte usw.)
  • Benötigt sie bestimmte Funktionen? (Dark Mode, i18n, CMS-Integration)

Schritt 2: Passendes Thema auswählen

Verwenden Sie web_fetch, um kostenlose, React-kompatible Themen zu durchsuchen:

URL: https://astro.build/themes/1/?search=&technology%5B%5D=react&price%5B%5D=free

Auswahlkriterien für Themen:

Für Blogs/Veröffentlichungen:

  • Suchen Sie nach Themen mit guter Typografie
  • Muss Markdown/MDX unterstützen
  • Sollte Tags/Kategorien haben
  • RSS-Feed-Unterstützung
  • Erwägen Sie: astro-paper, astro-blog-template

Für Portfolios:

  • Visuelle Projektpräsentation
  • Über-/Kontaktbereiche
  • Fließende Animationen
  • Erwägen Sie: astro-portfolio, personal-portfolio Themen

Für Dokumentationen:

  • Verwenden Sie Starlight (offizielles Astro-Dokumentations-Framework)
  • Funktionen: Suche, Seitenleiste, Dark Mode, i18n
  • Am besten geeignet für: Technische Dokumentationen, API-Referenzen, Anleitungen

Für Landingpages:

  • Hero-Bereich mit CTA
  • Abschnitte zu Funktionen/Vorteilen
  • Kontaktformulare
  • Konversionsoptimiert

Für E-Commerce:

  • Produktlisten und Filter
  • Warenkorb-Funktionalität
  • Zahlungsintegration bereit
  • Produktdetailseiten

Aktion: Rufen Sie die Themenseite ab, analysieren Sie verfügbare Themen und empfehlen Sie 2-3 Optionen, die am besten zu den Benutzeranforderungen passen. Erklären Sie, warum jedes Thema geeignet ist.

Schritt 3: Zugriff auf die Astro-Dokumentation

Wenn Sie eine spezifische Astro-Dokumentation benötigen, ziehen Sie Folgendes zu Rate:

  1. Integrierte Referenz: references/astro_docs.md – Enthält Kernkonzepte, Syntax und häufige Patterns von Astro
  2. Vollständige Dokumentation: Rufen Sie https://docs.astro.build/llms-full.txt auf, um umfassende Informationen zu erhalten

Wann Sie die Dokumentation zu Rate ziehen sollten:

  • Fragen zur Komponentensyntax → Referenz astro_docs.md
  • Routing und Seiten → Referenz astro_docs.md
  • Styling-Optionen → Referenz astro_docs.md
  • Fortgeschrittene Funktionen → Von docs.astro.build abrufen
  • Integrationseinrichtung → Von docs.astro.build abrufen
  • API-Details → Von docs.astro.build abrufen

Schritt 4: Astro-Projekt initialisieren

Create Astro CLI verwenden

# Neues Projekt erstellen
npm create astro@latest

# Oder mit einer spezifischen Vorlage
npm create astro@latest -- --template <theme-github-username>/<theme-repo>

Projektstruktur einrichten

Stellen Sie nach der Initialisierung eine ordnungsgemäße Struktur sicher:

projekt/
├── src/
│   ├── components/     # Wiederverwendbare Komponenten
│   ├── layouts/        # Seitenlayouts
│   ├── pages/          # Routen (ERFORDERLICH)
│   │   └── index.astro # Startseite
│   ├── content/        # Inhaltsammlungen (optional)
│   └── assets/         # Optimierte Bilder
├── public/             # Statische Assets
├── astro.config.mjs    # Konfiguration
├── package.json
└── tsconfig.json

Wichtig: Das Verzeichnis src/pages/ ist für das Routing ERFORDERLICH.

Schritt 5: Komponenten und Seiten entwickeln

Entwicklungspattern für Komponenten

  1. Komponentendatei erstellen in src/components/
  2. Props-Schnittstelle definieren (bei Verwendung von TypeScript)
  3. Komponentenskript schreiben (wird zur Build-Zeit ausgeführt)
  4. Vorlage erstellen (HTML mit Astro-Syntax)
  5. Bereichsbezogene Styles hinzufügen (optional)

Beispiel:

---
interface Props {
  titel: string;
  beschreibung?: string;
}
const { titel, beschreibung } = Astro.props;
---

<article>
  <h2>{titel}</h2>
  {beschreibung && <p>{beschreibung}</p>}
</article>

<style>
  article {
    padding: 1rem;
    border: 1px solid #ccc;
  }
</style>

Entwicklungspattern für Seiten

  1. Seitendatei erstellen in src/pages/ (bestimmt die Route)
  2. Erforderliche Komponenten und Layouts importieren
  3. getStaticPaths() definieren für dynamische Routen
  4. Seite aus Komponenten zusammensetzen

Beispielseite:

---
import Layout from '../layouts/Layout.astro';
import Hero from '../components/Hero.astro';

const titel = "Meine Seite";
---

<Layout title={titel}>
  <Hero />
  <!-- Weitere Inhalte -->
</Layout>

Interaktivität hinzufügen

Wenn Sie clientseitige Interaktivität benötigen:

  1. Framework-Integration installieren: npx astro add react
  2. Framework-Komponente erstellen (.jsx, .vue, .svelte)
  3. Mit Client-Direktive importieren und verwenden:
---
import ReactComponent from '../components/ReactComponent.jsx';
---

<!-- Statisch (kein JS) -->
<ReactComponent />

<!-- Interaktiv -->
<ReactComponent client:load />
<!-- Optionen: client:idle, client:visible, client:media -->

Schritt 6: Bei Bedarf Dokumentation zu Rate ziehen

Bevor Sie Code schreiben, lesen Sie die relevanten Abschnitte aus references/astro_docs.md:

  • Fragen zu Komponenten → Abschnitt „Komponenten-Syntax“ lesen
  • Routing-Probleme → Abschnitt „Routing“ lesen
  • Styling → Abschnitt „Styling“ lesen
  • Bilder → Abschnitt „Bilder und Assets“ lesen
  • Konfiguration → Abschnitt „Konfiguration“ lesen

Für fortgeschrittene Themen die vollständige Dokumentation abrufen:

web_fetch: https://docs.astro.build/llms-full.txt

Bewährte Praktiken

Leistungsoptimierung

  1. Komponenten standardmäßig statisch halten – Fügen Sie client:* nur hinzu, wenn es wirklich nötig ist
  2. Astros Image-Komponente verwenden – Automatische Optimierung
  3. Insel-Architektur nutzen – Minimales JavaScript standardmäßig
  4. Code-Splitting – Astro teilt automatisch pro Seite auf

Entwicklungsworkflow

  1. Mit der Struktur beginnen – Zuerst Layouts und grundlegende Seiten einrichten
  2. Komponentengetrieben – Wiederverwendbare Komponenten erstellen
  3. Typsicherheit – TypeScript für Props und bessere DX verwenden
  4. Inhaltssammlungen – Für typsicheres Inhaltsmanagement
  5. Lokal testen – Führen Sie npm run dev häufig aus

Häufige Patterns

  • Verwenden Sie Layouts für eine konsistente Seitenstruktur
  • Erstellen Sie eine SEO-Komponente für Meta-Tags
  • Richten Sie ordnungsgemäße TypeScript-Schnittstellen ein
  • Implementieren Sie ordnungsgemäße Fehlerseiten (404, 500)
  • Fügen Sie korrekte Alt-Texte zu Bildern hinzu
  • Verwenden Sie semantisches HTML

Fehlerbehebung

Häufige Probleme

„Module nicht gefunden“

  • Stellen Sie korrekte Importpfade sicher
  • Überprüfen Sie, ob Integrationen installiert sind
  • Verifizieren Sie, dass astro.config.mjs die korrekte Integrationseinrichtung enthält

„Seite wird nicht gerendert“

  • Stellen Sie sicher, dass die Datei im Verzeichnis src/pages/ liegt
  • Überprüfen Sie auf Syntaxfehler im Frontmatter
  • Stellen Sie die korrekte Dateierweiterung sicher (.astro, .md, .mdx)

„Styles werden nicht angewendet“

  • Bereichsbezogene Styles gelten nur für das eigene HTML der Komponente
  • Verwenden Sie is:global für globale Styles
  • Überprüfen Sie die Tailwind-Konfiguration, falls Tailwind verwendet wird

„Komponente nicht interaktiv“

  • Fügen Sie client:*-Direktive zu Framework-Komponenten hinzu
  • Stellen Sie sicher, dass die Integration installiert ist (z. B. @astrojs/react)
  • Überprüfen Sie die Browserkonsole auf JavaScript-Fehler

Ressourcen

Skripte

  • scripts/theme_analyzer.py – Hilft beim Abrufen und Analysieren von Astro-Themen von der offiziellen Themenseite. Verwenden Sie es, um Themenoptionen programmatisch basierend auf Technologie- und Preisfiltern zu erkunden.

Referenzen

  • references/astro_docs.md – Zuerst LESEN für Kernkonzepte von Astro, Komponentensyntax, Routing, Styling und häufige Patterns. Dies ist Ihre primäre Referenz für die Astro-Entwicklung.

Externe Ressourcen

Beispiel-Workflows

Beispiel 1: Einen Blog erstellen

Benutzer: „Ich möchte einen Blog mit Astro und React erstellen“

Workflow:

  1. Anforderungen identifizieren: Blog-Seite, benötigt React-Unterstützung, möchte ein kostenloses Thema
  2. Themen abrufen: web_fetch https://astro.build/themes/1/?technology%5B%5D=react&price%5B%5D=free
  3. Thema empfehlen: 2-3 blogorientierte Themen mit Erklärungen vorschlagen
  4. references/astro_docs.md lesen, um Komponenten-Patterns nachzuschlagen
  5. Einrichtung anleiten: Installationsbefehle und Struktur bereitstellen
  6. Beim Erstellen helfen: Blogbeitrag-Layout, Listenseite, einzelne Beitragsseiten erstellen
  7. Interaktivität hinzufügen: Zeigen, wie React-Komponenten mit client:load für Funktionen wie Kommentare eingefügt werden

Beispiel 2: Portfolio-Website

Benutzer: „Erstelle eine Portfolio-Seite für mich mit https://astro.build/“

Workflow:

  1. Anforderungen klären: Was soll präsentiert werden (Projekte, Fähigkeiten, Erfahrung?)
  2. Portfolio-Themen von der Astro-Themenseite abrufen
  3. Beste Übereinstimmung basierend auf dem Bereich des Benutzers empfehlen (Entwickler, Designer usw.)
  4. Komponentensyntax aus references/astro_docs.md lesen
  5. Projektstruktur mit ausgewähltem Thema einrichten
  6. Komponenten erstellen/anpassen (Hero, Projektraster, Über mich, Kontakt)
  7. Bei Bedarf fließende Übergänge hinzufügen
  8. Bilder mit Astros Image-Komponente optimieren

Beispiel 3: Dokumentationsseite

Benutzer: „Ich brauche eine Dokumentationsseite mit Suche und Dark Mode“

Workflow:

  1. Identifizieren: Dokumentationsseite, benötigt Suche und Dark Mode
  2. Starlight empfehlen (offizielles Astro-Dokumentations-Framework)
  3. Einrichtung zeigen: npm create astro@latest -- --template starlight
  4. Starlight-Dokumentation aus der vollständigen Astro-Dokumentation lesen
  5. Seitenleisten-Navigationsstruktur konfigurieren
  6. Inhaltsstruktur einrichten
  7. Dark Mode aktivieren (integriert)
  8. Suche konfigurieren (integriert mit Pagefind)

Wichtige Erinnerungen

  1. LESEN Sie zuerst references/astro_docs.md, bevor Sie Fragen zu Komponenten oder Syntax beantworten
  2. Rufen Sie Themen von der Astro-Themenseite ab, wenn der Benutzer einen Ausgangspunkt benötigt
  3. Verwenden Sie web_fetch für die vollständige Dokumentation, wenn nötig
  4. Halten Sie es einfach – Astro ist darauf ausgelegt, unkompliziert zu sein; überkomplizieren Sie nicht
  5. Insel-Architektur – Denken Sie daran, dass Komponenten standardmäßig statisch sind
  6. Typsicherheit – Ermutigen Sie zur Verwendung von TypeScript für eine bessere Entwicklungserfahrung

Erfolgskriterien

Ein Astro-Projekt ist korrekt eingerichtet, wenn:

  • ✅ Die Projektstruktur den Astro-Konventionen folgt
  • ✅ Das Verzeichnis src/pages/ existiert und mindestens index.astro enthält
  • ✅ Ein passendes Thema basierend auf den Anforderungen ausgewählt wurde
  • ✅ Komponenten den Astro-Syntax-Patterns folgen
  • ✅ Clientseitige Interaktivität nur dort hinzugefügt wurde, wo sie benötigt wird
  • ✅ TypeScript-Schnittstellen für Komponenten-Props definiert wurden
  • ✅ Bilder mit Astros Image-Komponente optimiert wurden
  • ✅ Die Seite erfolgreich mit npm run dev läuft

Verwandte Skills