@hexdspace/react 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,80 @@
+# @hexdspace/react
+
+React basic features, UI components plus a Tailwind v4-compatible theme CSS.
+
+## Install
+
+```sh
+pnpm add @hexdspace/react
+```
+
+Peer dependencies (install in your app):
+
+```sh
+pnpm add react react-dom react-router-dom radix-ui lucide-react react-toastify @tanstack/react-query
+```
+
+Tailwind requirements (for the theme + utilities):
+
+```sh
+pnpm add -D tailwindcss @tailwindcss/postcss tailwind-scrollbar
+```
+
+## Usage
+
+Import the theme into your Tailwind entry stylesheet and specify tailwind config:
+
+```css
+/* src/index.css */
+@import "@hexdspace/react/css";
+@config "../tailwind.config.ts"; /* adjust path if needed */
+
+/* Your app styles */
+```
+
+### Tailwind config
+
+Point Tailwind at this package so it can generate utilities used by the components.
+
+For a published package:
+
+```js
+// tailwind.config.js (app)
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{ts,tsx,js,jsx}",
+    "./node_modules/@hexdspace/react/dist/**/*.{js,ts,tsx}",
+  ],
+  theme: {
+    extend: {},
+  },
+};
+```
+
+For a monorepo/workspace:
+
+```js
+// tailwind.config.js (app)
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{ts,tsx,js,jsx}",
+    "../packages/react/src/**/*.{ts,tsx}",
+  ],
+};
+```
+
+### Component usage
+
+```tsx
+import { Button } from "@hexdspace/react";
+
+export function Example() {
+  return (
+    <Button variant="outline" chrome="push">
+      Click me
+    </Button>
+  );
+}
+```