Overview

Mina Scheduler is a customizable calendar and scheduler component for React and Next.js, published on npm as mina-scheduler. It displays and manages events in day, week and month views, and pairs shadcn/ui styling with Next UI components, so its README recommends using it inside a Next UI project.

The library is built around a SchedulerProvider that holds event state and a SchedularView that renders the calendar. Initial events can be passed as an array of typed Event objects, and the useScheduler hook exposes a dispatch function for updating events after mount. Views, buttons and the add-event modal can all be customized or replaced.

Features

Day, week and month views: Switch between views, with a separate set of views for mobile.
Event management: Add, update and delete events with built-in form validation.
Zod validation: Event data is checked against a schema.
Custom components: Supply a custom add-event modal and form, wired through register and errors props.
Class name overrides: Style the add, next and previous buttons and tab panels through a classNames prop.
Animations: Framer Motion animates transitions between views.
Mobile-friendly: A responsive layout optimized for small screens.

Tech stack

React, Next.js, shadcn/ui, Next UI, Framer Motion, Zod

Getting started

npm install mina-scheduler