react-beauty-calendar

React Beauty Calendar - RBC

🇬🇧 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.

An open source react calendar focused on simplicity and efficiency.

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

• clsx: Utility for conditionally joining classNames.
• cmdk: A fast, composable command menu for React.

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-calendar

Running the App

To run the app locally, follow these steps:

1. Clone the repository:

  git clone https://github.com/Dikendev/react-beauty-calendar.git

2. Navigate to the project directory:

  cd react-beauty-calendar

3. Install the dependencies:

  npm install

or

yarn install

4. Start the development server:

npm run dev

or

yarn dev

The app should now be running at http://localhost:5173.

Running Storybook

To run Storybook locally, follow these steps:

1. Ensure you are in the project directory:

cd react-beauty-calendar

2. Start Storybook:

npm run storybook

or

yarn storybook

Storybook 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.