npm - @argojun/react-components - Versions diffs - 1.0.0 → 1.0.3 - Mend

@argojun/react-components 1.0.0 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md CHANGED Viewed

@@ -1,41 +1,120 @@
 # @argojun/react-components
-A collection of beautifully crafted React components built with Tailwind CSS.
+A collection of beautifully crafted React components designed to work seamlessly with your Tailwind CSS project.
+📚 **[Documentation](https://www.argojun.in/)**
 ## Installation
 ```bash
+# npm
 npm install @argojun/react-components
+# yarn
+yarn add @argojun/react-components
+# pnpm
+pnpm add @argojun/react-components
 ```
-## Usage
+## ⚠️ Required Setup: Tailwind CSS Configuration
-Import components directly from the package:
+**This library requires Tailwind CSS in your project.** The components use Tailwind utility classes that need to be compiled by your project's Tailwind setup.
-```jsx
-import { Button, Input, Select, Checkbox, Radio, DateTimePicker, FileUpload, MultiSelect, Textarea, Icon } from '@argojun/react-components';
-```
+---
-### Include Styles
+### 🔷 For Tailwind CSS v3 Users
-Make sure to include the styles in your app:
+#### Option A: Using the Tailwind Preset (Recommended)
-```jsx
-import '@argojun/react-components/styles.css';
+The easiest way! Import our preset in your `tailwind.config.js`:
+```js
+const { tailwindPreset } = require('@argojun/react-components/tailwind');
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  presets: [tailwindPreset],
+  content: [
+    './src/**/*.{js,jsx,ts,tsx}',
+  ],
+  darkMode: 'class',
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};
 ```
-Or if you're using Tailwind CSS, you can include the component paths in your `tailwind.config.js`:
+#### Option B: Manual Configuration
+Add the library path to your `tailwind.config.js` content array:
 ```js
+/** @type {import('tailwindcss').Config} */
 module.exports = {
   content: [
-    // ... your paths
+    './src/**/*.{js,jsx,ts,tsx}',
+    // 👇 Add this line to include the component library
     './node_modules/@argojun/react-components/dist/**/*.js',
   ],
-  // ...
+  darkMode: 'class',
+  theme: {
+    extend: {},
+  },
+  plugins: [],
 };
 ```
+---
+### 🔶 For Tailwind CSS v4 Users
+If using Tailwind v4 with CSS-based configuration, add the `@source` directive to your CSS:
+```css
+@import "tailwindcss";
+/* Scan the component library for utility classes */
+@source "./node_modules/@argojun/react-components/dist/*.js";
+```
+---
+### Start Using Components
+Base styles (animations, scroll behavior, etc.) are **automatically injected** when you import any component — no separate CSS import needed!
+```jsx
+import { Button, Input, Select } from '@argojun/react-components';
+function App() {
+  return (
+    <div className="p-8">
+      <Button variant="primary" color="violet">
+        Click me
+      </Button>
+    </div>
+  );
+}
+```
+## Dark Mode Support
+All components support dark mode. Add the `dark` class to your `<html>` or parent element:
+```html
+<html class="dark">
+  <!-- Your app -->
+</html>
+```
+Or toggle it programmatically:
+```jsx
+document.documentElement.classList.toggle('dark');
+```
 ## Components
 ### Button
@@ -93,6 +172,13 @@ module.exports = {
 />
 ```
+**Props:**
+- `options`: Array of `{ value, label, icon?, description? }` or strings
+- `searchable`: boolean - Enable search/filter
+- `clearable`: boolean - Show clear button
+- `theme`: `'default'` | `'glass'` | `'minimal'` | `'outlined'` | `'filled'`
+- `color`: `'violet'` | `'blue'` | `'emerald'` | `'rose'` | `'amber'` | `'black'`
 ### MultiSelect
 ```jsx
@@ -104,37 +190,62 @@ module.exports = {
 />
 ```
+**Props:**
+- All Select props, plus:
+- `maxSelections`: number - Limit selections
+- `chipDisplay`: `'inline'` | `'count'` | `'compact'`
 ### Checkbox
 ```jsx
+// Standalone
 <Checkbox
   label="Accept terms"
   description="I agree to the terms and conditions"
   color="emerald"
 />
+// As a group
+<Checkbox.Group
+  label="Select options"
+  onChange={(values) => console.log(values)}
+>
+  <Checkbox value="opt1" label="Option 1" />
+  <Checkbox value="opt2" label="Option 2" />
+</Checkbox.Group>
 ```
 ### Radio
 ```jsx
-<Radio
+<Radio.Group
   name="plan"
-  label="Pro Plan"
-  description="$29/month"
-  variant="card"
-/>
+  label="Select a plan"
+  onChange={(value) => console.log(value)}
+>
+  <Radio value="basic" label="Basic" description="$9/month" />
+  <Radio value="pro" label="Pro" description="$29/month" variant="card" />
+</Radio.Group>
 ```
 ### DateTimePicker
 ```jsx
 <DateTimePicker
-  mode="datetime"
+  type="datetime"
   label="Appointment"
+  value={date}
+  onChange={(newDate) => setDate(newDate)}
   minDate={new Date()}
 />
 ```
+**Props:**
+- `type`: `'date'` | `'time'` | `'datetime'`
+- `value`: Date object
+- `onChange`: `(date: Date) => void`
+- `minDate` / `maxDate`: Date constraints
 ### FileUpload
 ```jsx
@@ -143,44 +254,68 @@ module.exports = {
   multiple
   maxFiles={5}
   maxSize={5 * 1024 * 1024}
-  showPreview
+  onFilesChange={(files) => console.log(files)}
 />
 ```
+**Props:**
+- `variant`: `'dropzone'` | `'compact'`
+- `multiple`: boolean
+- `accept`: string (MIME types)
+- `maxFiles`: number
+- `maxSize`: number (bytes)
 ### Textarea
 ```jsx
 <Textarea
   label="Description"
   placeholder="Enter description..."
-  autoResize
-  showCharCount
   maxLength={500}
+  helperText="Write a brief description"
 />
 ```
 ### Icon
+Built-in icon library with 150+ icons - no external dependencies needed!
 ```jsx
 <Icon icon="check" size="md" variant="solid" />
 <Icon icon="user" size="lg" />
+<Icon icon="heart" variant="outline" className="text-red-500" />
 ```
-## Peer Dependencies
+**Props:**
+- `icon`: string - Icon name (see full list in docs)
+- `size`: `'xs'` | `'sm'` | `'md'` | `'lg'` | `'xl'` | `'2xl'`
+- `variant`: `'outline'` | `'solid'`
+**Available Icons:**
+Navigation, actions, status, forms, media, files, commerce, shapes, weather, development, social brands, and more.
-This package requires the following peer dependencies:
+## Peer Dependencies
 ```json
 {
   "react": ">=17.0.0",
-  "react-dom": ">=17.0.0"
+  "react-dom": ">=17.0.0",
+  "tailwindcss": ">=3.0.0"
 }
 ```
-## Tailwind CSS
+## Troubleshooting
+### Styles not appearing?
+1. **Check Tailwind config**: Make sure you added the library path to `content` array, or use the preset
+2. **Rebuild your app**: Restart your dev server after config changes
+3. **Check browser console**: Look for any JavaScript errors
+### Dark mode not working?
-These components are built with Tailwind CSS. Make sure you have Tailwind configured in your project for the best experience.
+Make sure your `tailwind.config.js` has `darkMode: 'class'` and add the `dark` class to your root element.
 ## License
-MIT
+MIT © Arnav Gour