lizard-ui
v0.0.2
Published
Lizard UI — modern, stylish, minimalist React components. ESM/CJS package for Vite, Bun, and other bundlers.
Downloads
17
Maintainers
Readme
Lizard UI
Lizard UI is a React component library with shadcn-style primitives and Tailwind-native glass styling — gradients, blur, and saturation driven by theme CSS variables, no extra runtime.
Install
npm install lizard-ui
# bun add lizard-ui | pnpm add lizard-uiQuick start
// 1. Import the theme stylesheet once
import 'lizard-ui/styles/themes.css';// 2. Wrap your app
import { ThemeProvider } from 'lizard-ui';
export default function Root() {
return <ThemeProvider><App /></ThemeProvider>;
}// 3. Use components
import { Button, Card, CardContent } from 'lizard-ui';
<Card variant="glassPrimary">
<CardContent>
<Button variant="glassSecondary">Action</Button>
</CardContent>
</Card>Features
- 23 color themes — swap palettes at runtime via
data-themeon<html> - Light / dark / system —
ThemeProvider+useThemehook, persisted tolocalStorage - Glass variants —
CardandButtonglass surfaces tinted by themeprimary/secondarytokens - Standalone glass utilities — import individual glass class functions for custom components
- Modular types — one TypeScript file per component in
src/types/ - Tailwind-safe LIST_MAPs — all class strings statically present; no dynamic class generation
- Tree-shakeable — ESM + CJS, TypeScript declarations
Documentation
Full reference in docs/:
| | |
|---|---|
| Types | Variant unions, component props, theme types |
| Utils | cn, token parser, variant MAP constructors, glass functions |
| Components | Button, Card, Badge, BackgroundPattern, layout |
| Contexts | ThemeProvider, useTheme |
| Styles | Theme tokens, dark mode, custom themes, Tailwind config |
| Examples | Copy-paste snippets |
Dev scripts
| Script | Description |
|---|---|
| bun dev | Vite playground at localhost:5173 |
| bun run build | Rollup → dist/ (ESM + CJS + types + CSS) |
| bun run build:site | Vite static build → playground-dist/ |
| bun run test | Jest |
| bun run lint | ESLint |
| bun run typecheck | tsc --noEmit |
Contributing
Fork → branch → PR. See CONTRIBUTING.md.
License
MIT — see LICENSE.
Made by xarlizard
