react-beauty-calendar
v2.0.2
Published
React Library inspired by Google Calendar and Outlook.
Maintainers
Readme
🇬🇧 English 🇧🇷 Portuguese
With the need to implement an efficient scheduling system, I decided to create a library inspired by Google Calendar and Outlook. This library offers features such as appointment creation, drag and drop, resizing, and much more. ✨
Note: The current focus is on fixing performance issues.
Features
- Simple & Fast: Minimalist interface with powerful features
- Drag & Drop: Advanced appointment creation
- Open Source: MIT licensed, free forever
- Storybook available.
Technologies Used
Core Technologies
- React: A JavaScript library for building user interfaces.
- TypeScript: A strongly typed programming language that builds on JavaScript, providing type safety and better developer experience.
State Management
- Zustand: A small, fast, and scalable state-management library for React.
Date Utilities
- date-fns: A modern JavaScript date utility library for parsing, formatting, and manipulating dates.
- dayjs: A lightweight JavaScript date library for parsing, validating, and formatting dates.
Drag and Drop
- @dnd-kit/core: A modern drag-and-drop toolkit for React.
UI Components
- Radix UI: Accessible, unstyled UI components for building modern React applications.
Styling
- Tailwind CSS: A utility-first CSS framework for rapid UI development.
Build Tools
- Vite: A fast build tool and development server for modern web projects.
Testing
- Vitest: A blazing-fast unit testing framework for modern web applications.
- Playwright: An end-to-end testing framework for web applications.
Storybook
- Storybook: A tool for developing and testing UI components in isolation.
- Chromatic: Visual testing and review for Storybook components.
Linting and Formatting
- ESLint: A tool for identifying and fixing problems in JavaScript code.
Utilities
Development Tools
- Husky: Git hooks for automating tasks.
- Concurrently: Run multiple commands concurrently.
Installation
Install react-beauty-calendar in your project with your package manager of choice:
npm i react-beauty-calendarRunning the App
To run the app locally, follow these steps:
- Clone the repository:
git clone https://github.com/Dikendev/react-beauty-calendar.git- Navigate to the project directory:
cd react-beauty-calendar- Install the dependencies:
npm installor
yarn install- Start the development server:
npm run devor
yarn devThe app should now be running at http://localhost:5173.
Running Storybook
To run Storybook locally, follow these steps:
- Ensure you are in the project directory:
cd react-beauty-calendar- Start Storybook:
npm run storybookor
yarn storybookStorybook should now be running at http://localhost:6006.
Contributing
We welcome contributions! Please see our Contributing Guide for details.
New Component Proposals
Feel free to open a issue for new ideas and contributions.
Contact
For bug reports and feature requests, please use the issue tracker of this repository.
License
This project is licensed under the MIT License 2025.
