Installation

🚀 Erste Schritte Aktualisiert: 20. August 2026

Atlas in fünf Minuten lokal starten – mit npm, ohne externe Dienste.

Voraussetzungen

Atlas braucht nur zwei Dinge auf dem Rechner:

Werkzeug	Version	Prüfen mit
Node.js	22 oder neuer	`node -v`
npm	10 oder neuer	`npm -v`

Es werden keine externen Schriften, CDNs oder Analyse-Dienste geladen. Die Installation läuft vollständig offline, sobald die Pakete einmal im Cache sind.

Projekt anlegen

npm create astro -- --template JUNGHERZ/NotionKit-Web atlas
cd atlas
npm install
npm run dev

Der Dev-Server meldet sich unter http://localhost:4321/. Änderungen an Markdown-Dateien erscheinen sofort.

Erste Anpassungen

src/data/site.ts – Name, Beschreibung, Sprachen.
src/styles/brand.css – Markenfarbe, optional Serif-Headlines.
src/content/docs/ – diese Seiten durch eigene ersetzen.

💡

Die Theme-Wahl wird nur lokal im Browser gespeichert. Es gibt keinen Server, der etwas über Besucher weiß.

Bauen und veröffentlichen

npm run build      # statische Seite nach dist/
npm run preview    # lokal prüfen
npm test           # Smoke-Tests: Themes, Mobile, No-JS

Ein Push auf main löst den GitHub-Actions-Workflow aus: Test, Build, Deploy auf GitHub Pages.