prototype

Bundle React and TypeScript prototypes into a single HTML artifact.

Updated Sep 12, 2021
One-click install
npx skills add https://github.com/cerico/macfair --skill prototype-cerico
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prototype
Source: https://github.com/cerico/macfair/tree/main/files/claude/skills/prototype
Command: npx skills add https://github.com/cerico/macfair --skill prototype-cerico

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline, vite, tailwindcss, postcss, autoprefixer, @types/node, tailwindcss-animate, json5, class-variance-authority, clsx, tailwind-merge, lucide-react, next-themes, @radix-ui/react-accordion, @radix-ui/react-aspect-ratio, @radix-ui/react-avatar, @radix-ui/react-checkbox, @radix-ui/react-collapsible, @radix-ui/react-context-menu, @radix-ui/react-dialog, @radix-ui/react-dropdown-menu, @radix-ui/react-hover-card, @radix-ui/react-label, @radix-ui/react-menubar, @radix-ui/react-navigation-menu, @radix-ui/react-popover, @radix-ui/react-progress, @radix-ui/react-radio-group, @radix-ui/react-scroll-area, @radix-ui/react-select, @radix-ui/react-separator, @radix-ui/react-slider, @radix-ui/react-slot, @radix-ui/react-switch, @radix-ui/react-tabs, @radix-ui/react-toast, @radix-ui/react-toggle, @radix-ui/react-toggle-group, @radix-ui/react-tooltip, sonner, cmdk, vaul, embla-carousel-react, react-day-picker, react-resizable-panels, date-fns, react-hook-form, @hookform/resolvers, zod, and includes scripts (resource) components.

What problem does it solve?

This Skill helps developers rapidly prototype UI components by bundling React projects into a single, shareable HTML artifact, eliminating complex setup for demos.

Core Features & Use Cases

  • Lightweight React prototypes: Create small-scale demos with TS + React + Vite that export a standalone bundle.html.
  • Single-file artifact: The bundling process inlines JS/CSS into one bundle.html for easy sharing.
  • Workflow for quick demos: Initialize, develop in src, bundle, and share a bundled artifact.
  • Use Case: You need a quick UI interaction prototype to present to stakeholders without deploying a full app.

Quick Start

Run the bootstrap script to scaffold a new demo: bash scripts/init-artifact.sh my-demo cd my-demo pnpm install pnpm dev When ready to share, bundle into a single HTML: bash scripts/bundle-artifact.sh

Frequently Asked Questions about prototype

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

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

To bundle a React prototype into a single HTML file, use the provided script to scaffold a Vite project, develop your UI in the src directory, and run the bundle script to inline all JS and CSS assets into one portable bundle.html artifact.

What is the best way to share a React UI demo without deploying a full app?

The best way to share a React UI demo without deployment is generating a single-file HTML artifact, which inlines your TypeScript, React, and Tailwind CSS code into a portable bundle that stakeholders can open directly in any browser.

Does this single-file React bundler support Tailwind CSS and Radix UI components?

Yes, the single-file React bundler supports Tailwind CSS and Radix UI components. It pre-configures Vite with Tailwind CSS, Radix UI primitives, and other dependencies to ensure interactive UI elements compile correctly into the final HTML artifact.

Can I use TypeScript path aliases when building React prototypes?

Yes, you can use TypeScript path aliases when building React prototypes. The bundling environment integrates a dedicated parcel resolver for TS paths, ensuring your alias configurations resolve correctly during the single-file HTML generation process.

Why inline JavaScript and CSS assets into one HTML file for client pitches?

Inlining JavaScript and CSS assets into one HTML file for client pitches eliminates complex deployment setup and external dependencies. This lightweight single-file artifact approach ensures your interactive React experiments are instantly shareable and executable offline.

What are the limitations of bundling a full React application into a standalone bundle.html?

Bundling a React application into a standalone bundle.html is limited to lightweight prototypes and quick UI demos. It targets small-scale interactive experiments rather than full-scale applications, because inlining all assets into a single file restricts routing and backend integration.