Web Artifacts Builder
Pour créer des artefacts frontend puissants sur claude.ai, suivez ces étapes :
- Initialisez le dépôt frontend en utilisant
scripts/init-artifact.sh - Développez votre artefact en modifiant le code généré
- Regroupez tout le code en un seul fichier HTML avec
scripts/bundle-artifact.sh - Affichez l'artefact à l'utilisateur
- (Optionnel) Testez l'artefact
Stack : React 18 + TypeScript + Vite + Parcel (bundling) + Tailwind CSS + shadcn/ui
Directives de conception et de style
TRÈS IMPORTANT : Pour éviter ce que l'on appelle souvent « AI slop », évitez d'utiliser des mises en page centrées excessives, des dégradés violets, des coins arrondis uniformes et la police Inter.
Démarrage rapide
Étape 1 : Initialiser le projet
Exécutez le script d'initialisation pour créer un nouveau projet React :
bash scripts/init-artifact.sh <nom-du-projet>
cd <nom-du-projet>
Ceci crée un projet entièrement configuré avec :
- ✅ React + TypeScript (via Vite)
- ✅ Tailwind CSS 3.4.1 avec le système de thème shadcn/ui
- ✅ Alias de chemin (
@/) configurés - ✅ 40+ composants shadcn/ui préinstallés
- ✅ Toutes les dépendances Radix UI incluses
- ✅ Parcel configuré pour le bundling (via .parcelrc)
- ✅ Compatibilité Node 18+ (détection automatique et version Vite fixée)
Étape 2 : Développer votre artefact
Pour construire l'artefact, modifiez les fichiers générés. Consultez Tâches de développement courantes ci-dessous pour obtenir des conseils.
Étape 3 : Regrouper en un seul fichier HTML
Pour regrouper l'application React en un seul artefact HTML :
bash scripts/bundle-artifact.sh
Ceci crée bundle.html – un artefact autonome avec tout le JavaScript, CSS et dépendances intégrés. Ce fichier peut être directement partagé dans les conversations Claude en tant qu'artefact.
Prérequis : Votre projet doit avoir un fichier index.html dans le répertoire racine.
Ce que fait le script :
- Installe les dépendances de bundling (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
- Crée la configuration
.parcelrcavec le support des alias de chemin - Construit avec Parcel (sans source maps)
- Intègre tous les actifs dans un seul fichier HTML en utilisant html-inline
Étape 4 : Partager l'artefact avec l'utilisateur
Enfin, partagez le fichier HTML regroupé dans la conversation avec l'utilisateur afin qu'il puisse le visualiser en tant qu'artefact.
Étape 5 : Tester/visualiser l'artefact (Optionnel)
Remarque : Il s'agit d'une étape complètement optionnelle. Effectuez-la uniquement si nécessaire ou si demandé.
Pour tester/visualiser l'artefact, utilisez les outils disponibles (y compris d'autres Skills ou des outils intégrés comme Playwright ou Puppeteer). En général, évitez de tester l'artefact au préalable, car cela ajoute de la latence entre la demande et le moment où l'artefact finalisé peut être vu. Testez plus tard, après avoir présenté l'artefact, si demandé ou si des problèmes surviennent.
Référence
- Composants shadcn/ui : https://ui.shadcn.com/docs/components