@buttonschool/create-wireframe
v0.2.2
Published
Scaffold a Vite-based wireframe prototype with tokens, components, Comic Neue, and Lucide
Readme
@buttonschool/create-wireframe
Scaffold a Vite (vanilla) wireframe prototype with design tokens, Comic Neue font, and Lucide icons. Light setup, code-gen friendly.
Create a project
pnpm create @buttonschool/wireframe my-app
cd my-app
pnpm devOr with npm or yarn: npm create @buttonschool/wireframe my-app / yarn create @buttonschool/wireframe my-app. The CLI runs the matching install command (pnpm, npm, or yarn). Then pnpm build and pnpm preview (or npm run build / npm run preview) to build and preview production.
What’s included
- Vite – dev server with HMR,
pnpm dev/pnpm build/pnpm preview - Three-page starter – Start (small word game, Spelling Bee–style), Tokens (design token showcase), and Components (wireframe kit showcase). Nav is a Nunjucks partial (
_partials/nav.html) usingsite.nav.*fromsrc/strings.json;currentis set per page invite.config.jsforaria-current="page". Styles are linked from each page’s<head>via<link rel="stylesheet" href="/src/styles/main.css">. To add a page: add a root.htmlfile, add a link in_partials/nav.html, add avariablesentry invite.config.js(e.g.{ ...strings, current: "yourpage" }), and add an@importfor the page’s CSS insrc/styles/main.css. - Design tokens –
src/kit/tokens.css: grayscale palette, semantic color aliases, spacing scale, border radius, typography (Comic Neue) - Wireframe kit –
src/kit/components/: button, input, textarea, checkbox, radio, select, label, field (one CSS file per component). Uses--wire-*tokens and.wire-*classes (e.g..wire-button,.wire-input). Use.wire-fieldto wrap a label and its control;.wire-select-wrapfor a CSS-only select chevron. - Comic Neue – via @fontsource/comic-neue (OFL-1.1). Monaspace Argon is also included for code/samples on the Tokens and Components pages.
- Lucide – dependency only; Lucide icons – import and render as SVG as needed
- AGENTS.md – in the generated project: fuller instructions for AI/code-gen (tokens, dev server, icons, styles layout)
- Accessibility – starter includes basic a11y: live regions, current-page marking on nav, and visually hidden labels where needed; extend as you build.
License
ISC.
