# 🇪🇹 react-ethiopian-datepicker
A professional, high-performance, and high-customizability dual-calendar React component for **Ethiopian (ዓ.ም)** and **Gregorian (G.C.)** dates.
## 📦 Installation
```bash
pnpm add react-ethiopian-datepicker
# or
npm install react-ethiopian-datepicker
# or
yarn add react-ethiopian-datepicker
```
> **Zero Dependencies**: This component is built with native SVGs and zero external dependencies (other than React), keeping your bundle size extremely small.
> **Note**: This package can also be installed directly from GitHub if preferred:
> `npm install Azime12/react-ethiopian-datepicker`
## 🛠 Usage
```jsx
import { EthiopianDatePicker } from 'react-ethiopian-datepicker';
// If using the compiled version
import 'react-ethiopian-datepicker/dist/style.css';
function Application() {
const [date, setDate] = useState(null);
return (
);
}
```
## 🎨 Professional Customization
The date picker provides deep access to styling via the `customization` prop:
- **Colors**: Change primary colors, backgrounds, text, and borders.
- **Sizes**: Choose between `sm`, `md`, or `lg` layouts.
- **Icons**: Pass your own React components to override default icons.
- **Labels**: Fully localize labels for months and days (Default: Amharic).
Check out DATE_PICKER_DOC.md for the full API.
## 💻 Demo Application
An example Vite application is included in the `frontend` directory to demonstrate various themes and configurations.
To run it:
1. `pnpm install` (in the root)
2. `cd frontend`
3. `pnpm install`
4. `pnpm dev`
## 🤝 Contributing
Contributions are welcome! Whether it's fixing a bug, adding a feature, or improving documentation.
Please see CONTRIBUTING.md for guidelines.
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.