web-artifacts-builder

Builds React, Tailwind, and shadcn/ui projects and bundles them into single HTML artifacts.

6|1|Updated Sep 3, 2026
One-click install
npx skills add https://github.com/jasonzhu0922-sketch/agentloop --skill web-artifacts-builder-jasonzhu0922-sketch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-artifacts-builder
Source: https://github.com/jasonzhu0922-sketch/agentloop/tree/main/packages/agentloop-skills/skills/web-artifacts-builder
Command: npx skills add https://github.com/jasonzhu0922-sketch/agentloop --skill web-artifacts-builder-jasonzhu0922-sketch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react, typescript, vite, tailwindcss, parcel, html-inline, pnpm, and includes scripts (resource) components.

What problem does it solve? Creating complex, multi-component web artifacts with state management, routing, and a full component system normally requires manual project scaffolding, dependency configuration, and bundling setup. This Skill automates that entire pipeline so a React + TypeScript + Tailwind + shadcn/ui project can be initialized, developed, and shipped as one self-contained HTML file. ## Core Features & Use Cases - Project Initialization: scripts/init-artifact.sh scaffolds a Vite React-TypeScript project with Tailwind CSS 3.4.1, shadcn/ui theming, path aliases, and 40+ pre-installed shadcn/ui components, with automatic Node version detection and Vite pinning. - Single-File Bundling: scripts/bundle-artifact.sh builds the app with Parcel and inlines all JavaScript and CSS into one bundle.html artifact ready to share. - Use Case: When asked for an interactive dashboard or multi-view app artifact, initialize the project, edit the generated React code using shadcn/ui components, then bundle it into a single HTML file the user can open directly in a browser. ## Quick Start Ask the agent to build a complex interactive web artifact, such as a dashboard with routing and shadcn/ui components, and have it initialize the project, develop the code, and bundle it into a single HTML file.

Frequently Asked Questions about web-artifacts-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bundle a React app into a single HTML file?

Run scripts/bundle-artifact.sh from the project root. It installs Parcel and html-inline, builds the app without source maps, and inlines all JavaScript and CSS into one bundle.html file that can be shared directly as an artifact.

How do I set up a React project with shadcn/ui and Tailwind CSS?

Run scripts/init-artifact.sh with a project name. It creates a Vite React-TypeScript project, installs Tailwind CSS 3.4.1 with the shadcn/ui theming system, configures path aliases, and extracts 40+ pre-built shadcn/ui components into src/.

When should I use this instead of a single-file HTML artifact?

Use this stack when the artifact needs state management, routing, shadcn/ui components, or complex custom interactions. For simple standalone HTML or JSX artifacts, writing the HTML/CSS/JS directly is more appropriate.

Does the init script work with older Node.js versions?

Node.js 18 or higher is required. The script auto-detects the Node version and pins Vite to 5.4.11 for Node 18, while Node 20 and above use the latest Vite release.

Why does bundle-artifact.sh fail with an index.html error?

The bundling script requires an index.html entry point in the project root and must be run from the directory containing package.json. Verify you are inside the initialized project directory before running it.