@amelharrak/eldo-ui 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eldo UI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @amelharrak/eldo-ui (React)
+
+A modern, lightweight, and accessible React component library. Fully tree-shakeable and built with TypeScript.
+
+![Eldo UI Version](https://img.shields.io/npm/v/@amelharrak/eldo-ui)
+![License](https://img.shields.io/npm/l/@amelharrak/eldo-ui)
+![Size](https://img.shields.io/bundlephobia/minzip/@amelharrak/eldo-ui)
+
+## 🚀 Features
+
+- **23+ React Components** - Fully typed and ready to use
+- **Tree-Shakeable** - Import only what you need (Full bundle ~10kb gzipped)
+- **TypeScript** - Built-in type definitions
+- **Accessible** - WAI-ARIA compliant
+- **Customizable** - Sass variables and CSS custom properties
+- **Zero Runtime Dependencies** - Depends only on React
+
+## 📦 Installation
+
+```bash
+npm install @amelharrak/eldo-ui
+# or
+yarn add @amelharrak/eldo-ui
+```
+
+## 🎯 Quick Start
+
+### 1. Import Styles
+
+Add the styles to your root `App.js` or `index.js`:
+
+```javascript
+import '@amelharrak/eldo-ui/dist/css/eldo.css';
+```
+
+### 2. Use Components
+
+```tsx
+import { Button, Modal, Card } from '@amelharrak/eldo-ui';
+import { useState } from 'react';
+
+function App() {
+  const [isOpen, setIsOpen] = useState(false);
+
+  return (
+    <div className="p-4">
+      <Card>
+        <Card.Body>
+          <h1>Hello Eldo UI!</h1>
+          <Button variant="primary" onClick={() => setIsOpen(true)}>
+            Open Modal
+          </Button>
+        </Card.Body>
+      </Card>
+
+      <Modal isOpen={isOpen} onClose={() => setIsOpen(false)} title="Welcome">
+        <p>This is a React Modal component.</p>
+      </Modal>
+    </div>
+  );
+}
+```
+
+## 📖 Components
+
+### Core
+
+- **Button** - Multiple variants, sizes, and loading states
+- **Alert** - Dismissible alerts with variations
+- **Card** - Flexible card layouts (`Card.Header`, `Card.Body`, `Card.Footer`)
+- **Badge** & **Spinner**
+
+### Interactive
+
+- **Modal** - Accessible dialogs
+- **Dropdown** - Context menus and actions
+- **Accordion** - Collapsible sections
+- **Tabs** - Tabbed navigation
+- **Collapse** - Expand/collapse toggles
+- **Tooltip** & **Popover** - Contextual info
+
+### Forms
+
+- **Input**, **Select**, **Switch**, **Checkbox**, **Radio**
+- **InputOTP** - One-time password input
+- **FileUpload** - Drag & drop zone
+
+### Layout & Navigation
+
+- **Navbar**, **Pagination**, **Breadcrumb**
+- **Carousel**, **Offcanvas**
+
+## 🎨 Customization
+
+You can customize the look and feel using CSS variables or Sass.
+
+```css
+:root {
+  --eldo-primary: #6366f1;
+  --eldo-border-radius: 0.5rem;
+  --eldo-font-family: 'Inter', sans-serif;
+}
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT © Eldo UI Team