Web Artifacts Builder
Para construir artefactos frontend potentes para claude.ai, sigue estos pasos:
- Inicializa el repositorio frontend usando
scripts/init-artifact.sh - Desarrolla tu artefacto editando el código generado
- Empaqueta todo el código en un único archivo HTML usando
scripts/bundle-artifact.sh - Muestra el artefacto al usuario
- (Opcional) Prueba el artefacto
Stack: React 18 + TypeScript + Vite + Parcel (empaquetado) + Tailwind CSS + shadcn/ui
Pautas de diseño y estilo
MUY IMPORTANTE: Para evitar lo que a menudo se conoce como "AI slop", evita el uso excesivo de diseños centrados, degradados púrpura, esquinas redondeadas uniformes y la fuente Inter.
Inicio rápido
Paso 1: Inicializar el proyecto
Ejecuta el script de inicialización para crear un nuevo proyecto React:
bash scripts/init-artifact.sh <project-name>
cd <project-name>
Esto crea un proyecto completamente configurado con:
- ✅ React + TypeScript (a través de Vite)
- ✅ Tailwind CSS 3.4.1 con sistema de temas shadcn/ui
- ✅ Alias de ruta (
@/) configurados - ✅ Más de 40 componentes shadcn/ui preinstalados
- ✅ Todas las dependencias de Radix UI incluidas
- ✅ Parcel configurado para empaquetado (a través de .parcelrc)
- ✅ Compatibilidad con Node 18+ (detecta automáticamente y fija la versión de Vite)
Paso 2: Desarrolla tu artefacto
Para construir el artefacto, edita los archivos generados. Consulta Tareas comunes de desarrollo más abajo para obtener orientación.
Paso 3: Empaquetar en un único archivo HTML
Para empaquetar la aplicación React en un único artefacto HTML:
bash scripts/bundle-artifact.sh
Esto crea bundle.html - un artefacto autónomo con todo el JavaScript, CSS y dependencias incrustadas. Este archivo se puede compartir directamente en conversaciones de Claude como artefacto.
Requisitos: Tu proyecto debe tener un index.html en el directorio raíz.
Lo que hace el script:
- Instala dependencias de empaquetado (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
- Crea la configuración
.parcelrccon soporte para alias de ruta - Compila con Parcel (sin mapas de origen)
- Incrusta todos los activos en un único HTML usando html-inline
Paso 4: Comparte el artefacto con el usuario
Finalmente, comparte el archivo HTML empaquetado en la conversación con el usuario para que pueda verlo como artefacto.
Paso 5: Probar/Visualizar el artefacto (Opcional)
Nota: Este es un paso completamente opcional. Realízalo solo si es necesario o si se solicita.
Para probar/visualizar el artefacto, utiliza las herramientas disponibles (incluyendo otras Skills o herramientas integradas como Playwright o Puppeteer). En general, evita probar el artefacto de antemano, ya que añade latencia entre la solicitud y el momento en que se puede ver el artefacto terminado. Prueba después, después de presentar el artefacto, si se solicita o si surgen problemas.
Referencia
- Componentes shadcn/ui: https://ui.shadcn.com/docs/components