Chainsaw UI

React component library built with Tailwind CSS and class-variance-authority.

Stack

• React 19
• TypeScript
• Vite (library mode)
• Tailwind CSS
• VitePress
• Vitest + Testing Library

Installation

npm install @chainsaw-ui/react

Usage

import { Button, Input } from '@chainsaw-ui/react'
import '@chainsaw-ui/react/styles.css'

export function Form() {
  return (
    <div className="space-y-3">
      <Input placeholder="Your name" />
      <Button>Save</Button>
    </div>
  )
}

Scripts

npm run dev            # preview local
npm run build          # library build in dist/
npm run typecheck      # type checking
npm run lint           # lint
npm run test           # unit tests
npm run docs:dev       # docs VitePress

Structure

• src/components: library components
• src/lib: internal utilities
• src/styles: Tailwind base styles
• docs: VitePress documentation

Publishing

1. Update name and version in package.json.
2. Run full validation with npm run check.
3. Verify package contents with npm run pack:check.
4. Login to npm with npm login.
5. Publish with npm publish.

CI

The CI workflow runs on push and pull request to main, executing:

• npm run check
• npm run pack:check