Problem: Der claude.ai-Projekt-Export liefert gebautes HTML (Eleventy-Includes
expandiert, Frontmatter + gate.js entfernt) plus Artefakte. Roh deployt = kaputt:
Passwortschutz weg, Bilder 404, interne Docs öffentlich, Build bricht mit Duplicate-Permalink.
Lösung: Ein Durchlauf repariert alle bekannten Export-Schäden.
# 1. Export entpacken (irgendwohin)
unzip "Agora website import.zip" -d /tmp/export
# 2. Sanitizen — Projekt-Root ist der Ordner mit package.json
scripts/sanitize-claude-export.sh \
/tmp/export/uploads/agora-website-claude-import \
--assets-from /pfad/zu/diesem/repo
# 3. Deployen
cd /tmp/export/uploads/agora-website-claude-import
vercel deploy --prod --scope agora-software
| # | Schaden | Fix |
|---|---|---|
| 1 | Vorgebaute blog/posts/*.html neben .md → Build-Abbruch (Duplicate Permalink) |
Artefakt-.html entfernt |
| 2 | _CLAUDE-IMPORT.md / _PROJEKT-INSTRUKTION.md / AGORA-DESIGN-DATA.md → öffentlich erreichbar |
gelöscht |
| 3 | Interner Codename-Kommentar in js/config.js |
entfernt |
| 4 | vercel.json ohne Region → Functions in USA (DSGVO) |
regions: ["fra1"] |
| 5 | .vercelignore *.md → killt Blog-Post-Deploy |
/*.md (nur Root) |
| 6 | gate.js aus allen Seiten entfernt (Passwortschutz weg) |
Build-Transform re-injectet es sitewide |
| 7 | Schwere PNGs aus Export gestrippt → 404 | aus --assets-from nachgezogen |
Nach dem Build prüft das Script automatisch: alle referenzierten Assets im _site/,
gate.js auf allen Seiten, keine internen Docs im Output. Exit ≠ 0 = Hand anlegen.
--assets-from <dir> — Quelle für fehlende Assets (i.d.R. dieses Repo)--no-build — nur Files reparieren, Build/Verify überspringenHinweis zum Workflow: Dieses Script ist die Brücke, solange Inhalte in claude.ai entstehen. Es macht den Export deploybar, synchronisiert aber nicht zurück in die Eleventy-Template-Source dieses Repos. Wer die Template-Source pflegen will, muss Content-Änderungen manuell in die
.html/.njkzurückmergen.