@anyemp/ui-kit 1.3.1

package/README.md

@@ -0,0 +1,50 @@
+# @anyemp/ui-kit
+
+A modern React UI component library built with Vite and TypeScript. Tokens-driven theming, full dark mode support, and tree-shakeable exports.
+
+## Documentation
+
+- **[Design System Overview](./DESIGN.md)** — Principles, tokens, decision guide
+- **[Full Documentation Index](./docs/README.md)** — All components, hooks, contributing
+- **[Installation](./docs/installation.md)** — Setup and framework integration
+- **[Theming & Customization](./docs/theming-and-customization.md)** — Colors, gradients, dark mode
+- **[Design Tokens](./TOKENS.md)** — CSS variables cheat-sheet
+
+## Quick Install
+
+```bash
+npm install @anyemp/ui-kit
+```
+
+## Usage
+
+```tsx
+import { Button } from '@anyemp/ui-kit';
+import '@anyemp/ui-kit/styles';
+
+function App() {
+  return (
+    <Button variant="filled" color="primary" onClick={() => alert('Clicked!')}>
+      Click Me
+    </Button>
+  );
+}
+```
+
+For the full component API see [docs/components/Button.md](./docs/components/Button.md) and the rest of [docs/README.md](./docs/README.md).
+
+## Development
+
+```bash
+npm install       # install dependencies
+npm run dev       # Vite dev server
+npm run storybook # Storybook on port 6006
+npm run build     # Build library to dist/
+npm run lint      # ESLint
+```
+
+Contributors: see [docs/contributing/README.md](./docs/contributing/README.md).
+
+## License
+
+MIT