Web Artifacts Builder
Zum Erstellen leistungsstarker Frontend-Artefakte für claude.ai gehen Sie wie folgt vor:
- Initialisieren Sie das Frontend-Repository mit
scripts/init-artifact.sh - Entwickeln Sie Ihr Artefakt, indem Sie den generierten Code bearbeiten
- Bündeln Sie den gesamten Code mit
scripts/bundle-artifact.shin eine einzelne HTML-Datei - Zeigen Sie das Artefakt dem Benutzer an
- (Optional) Testen Sie das Artefakt
Stack: React 18 + TypeScript + Vite + Parcel (Bündelung) + Tailwind CSS + shadcn/ui
Design- & Stilrichtlinien
SEHR WICHTIG: Um das zu vermeiden, was oft als "KI-Schlonz" bezeichnet wird, vermeiden Sie übermäßig zentrierte Layouts, lila Farbverläufe, einheitliche abgerundete Ecken und die Schriftart Inter.
Schnellstart
Schritt 1: Projekt initialisieren
Führen Sie das Initialisierungsskript aus, um ein neues React-Projekt zu erstellen:
bash scripts/init-artifact.sh <projekt-name>
cd <projekt-name>
Dies erstellt ein vollständig konfiguriertes Projekt mit:
- ✅ React + TypeScript (über Vite)
- ✅ Tailwind CSS 3.4.1 mit shadcn/ui-Themingsystem
- ✅ Pfadaliase (
@/) konfiguriert - ✅ 40+ vorinstallierte shadcn/ui-Komponenten
- ✅ Alle Radix UI-Abhängigkeiten enthalten
- ✅ Parcel für die Bündelung konfiguriert (über .parcelrc)
- ✅ Node 18+ Kompatibilität (erkennt und fixiert automatisch die Vite-Version)
Schritt 2: Entwickeln Sie Ihr Artefakt
Bearbeiten Sie die generierten Dateien, um das Artefakt zu erstellen. Siehe Allgemeine Entwicklungsaufgaben unten für eine Anleitung.
Schritt 3: In eine einzelne HTML-Datei bündeln
Zum Bündeln der React-App in ein einzelnes HTML-Artefakt:
bash scripts/bundle-artifact.sh
Dies erstellt bundle.html – ein autarkes Artefakt mit allen JavaScript-, CSS- und Abhängigkeiten, die inline eingebettet sind. Diese Datei kann direkt in Claude-Konversationen als Artefakt geteilt werden.
Anforderungen: Ihr Projekt muss eine index.html im Stammverzeichnis haben.
Was das Skript macht:
- Installiert Bündelungsabhängigkeiten (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
- Erstellt eine
.parcelrc-Konfiguration mit Unterstützung für Pfadaliase - Baut mit Parcel (keine Source Maps)
- Bündelt alle Assets mithilfe von html-inline in eine einzelne HTML-Datei
Schritt 4: Teilen Sie das Artefakt mit dem Benutzer
Teilen Sie die gebündelte HTML-Datei schließlich im Gespräch mit dem Benutzer, damit dieser sie als Artefakt anzeigen kann.
Schritt 5: Testen/Visualisieren des Artefakts (Optional)
Hinweis: Dies ist ein vollständig optionaler Schritt. Führen Sie ihn nur bei Bedarf oder auf Anfrage durch.
Zum Testen/Visualisieren des Artefakts verwenden Sie verfügbare Tools (einschließlich anderer Skills oder integrierter Tools wie Playwright oder Puppeteer). Im Allgemeinen vermeiden Sie es, das Artefakt im Voraus zu testen, da dies die Latenz zwischen der Anfrage und der Anzeige des fertigen Artefakts erhöht. Testen Sie später, nach der Präsentation des Artefakts, wenn dies angefordert wird oder Probleme auftreten.
Referenz
- shadcn/ui-Komponenten: https://ui.shadcn.com/docs/components