Minecraft Gilde Web

Offizielle Website von Minecraft-Gilde.de (Minecraft-Server: Minecraft Gilde), gebaut mit Astro.

Tech-Stack

• Astro (statische Seite)
• TypeScript (strict)
• Tailwind CSS
• React (Astro Islands)
• Vitest (Unit-Tests)
• Node.js >= 22

Schnellstart

npm install
npm run dev

Dev-Server: http://localhost:4321

Wichtige Befehle

Befehl	Zweck
npm run dev	Lokale Entwicklung
npm run build	Produktionsbuild nach dist/
npm run preview	Lokale Vorschau des Builds
npm run check	Astro Type-/Template-Check
npm run lint	ESLint
npm run test	Unit-Tests (Vitest)
npm run test:e2e	End-to-End-Tests (Playwright)
npm run config:check	Konfigurations-Drift prüfen
npm run format:check	Prettier-Check (CI-tauglich)

Inhalte pflegen

• Befehle: src/content/commands/list.json
• Regeln: src/content/rules/main.json
• FAQ: src/content/faq/main.json
• Tutorial: src/content/tutorial/*.md

Hinweis: In Regeln werden Abschnitte teilweise als HTML-Strings gepflegt. Inhalte sauber escapen.

Projektbereiche

• src/pages/ für Seiten
• src/layouts/ für Layouts
• src/components/ für UI-Komponenten
• src/features/ für Feature-Module
• src/scripts/ für Browser-Logik
• src/content/ für redaktionelle Inhalte
• public/ für statische Assets und Server-Dateien
• scripts/ für Build-Helfer

Doku unter docs/

• Doku-Index
• Konfiguration und Umgebungsvariablen
• Frontend-Bootstrap und Ladeverhalten
• Content-Collections und Datenformate
• SEO, Canonical und strukturierte Daten
• Build- und Output-Besonderheiten
• Teststrategie (Unit und E2E)
• Projektstruktur und Frontend-Konventionen
• Statistik-API und lokaler Proxy
• Live-Daten Architektur
• Content Security Policy (CSP)

Qualität

Empfohlener lokaler Gate-Run:

npm run format:check
npm run lint
npm run check
npm run test

Bei Build-/Routing-/Asset-Änderungen zusätzlich:

npm run build

CI-Workflow: .github/workflows/quality.yml

Deployment

• npm run build erzeugt die statische Ausgabe in dist/.
• Inhalte aus public/ werden 1:1 nach dist/ kopiert.