https://github.com/tapiwamakandigona/react-ui-kit
Minimal React UI component library with dark theme, TypeScript, and zero dependencies | Button, Input, Modal, Toast, Card, Badge
https://github.com/tapiwamakandigona/react-ui-kit
component-library css-custom-properties dark-theme design-system jest react typescript ui-kit vite zero-dependencies
Last synced: about 2 months ago
JSON representation
Minimal React UI component library with dark theme, TypeScript, and zero dependencies | Button, Input, Modal, Toast, Card, Badge
- Host: GitHub
- URL: https://github.com/tapiwamakandigona/react-ui-kit
- Owner: tapiwamakandigona
- License: other
- Created: 2026-02-18T09:49:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-27T13:56:19.000Z (3 months ago)
- Last Synced: 2026-02-27T18:46:17.422Z (3 months ago)
- Topics: component-library, css-custom-properties, dark-theme, design-system, jest, react, typescript, ui-kit, vite, zero-dependencies
- Language: TypeScript
- Homepage:
- Size: 65.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
React UI Component Library (TypeScript)
A minimal, zero-dependency React component library with dark theme support, full TypeScript typings, Jest test coverage, and Storybook-ready exports.
---
## ⚡ Why Zero Dependencies?
Most UI libraries ship megabytes of CSS frameworks and peer dependencies. This library has **zero runtime dependencies** — every component is built from raw CSS custom properties and React primitives, giving you total control over bundle size.
## 🧩 Components
| Component | Props API | Features |
|-----------|----------|----------|
| **Button** | `variant`, `size`, `disabled`, `loading` | Primary/Secondary/Danger, spinner state |
| **Input** | `label`, `error`, `type` | Validation states, dark mode |
| **Modal** | `open`, `onClose`, `title` | Portal rendering, ESC key, backdrop click |
| **Toast** | `message`, `type`, `duration` | Auto-dismiss, stacking, success/error/info |
| **Card** | `title`, `footer` | Flexible content slots |
| **Badge** | `variant`, `count` | Color-coded status indicators |
---
## 🛠️ Stack
- **React 19** + **TypeScript** (strict mode)
- **CSS Custom Properties** (zero CSS frameworks)
- **Jest + React Testing Library** (unit tests)
- **Vite** (build + dev server)
---
## 🚀 Quick Start
```bash
git clone https://github.com/tapiwamakandigona/react-ui-kit.git
cd react-ui-kit
npm install
npm run dev
```
```bash
npm test # Run test suite
npm run build # Build library
```
---