A sleek and intuitive calendar application built with React, TypeScript, and Tailwind CSS using indexed DB as events storage.
- Create Events: Add new events with detailed information including name, description, start/end times, and categories
- Edit Events: Modify existing events with validation and error handling
- Delete Events: Remove events with confirmation prompts
- Event Categories: Organize events by Work, Personal, Meeting, or Reminder categories
- Day View: Focus on a single day's events with hourly time slots
- Week View: See an entire week at a glance with ISO week formatting
- Month Navigation: Browse through months with an intuitive calendar picker
- Today Navigation: Quick jump back to the current date
- Modern UI: Clean, minimalist interface with smooth animations
- Keyboard Navigation: Full keyboard accessibility support
- Click-to-Create: Click on any time slot to create a new event
- Visual Indicators: Event dots on calendar dates and color-coded categories
- IndexedDB Integration: Local storage for offline functionality
- ICS Import: Import events from external calendar files
- Data Persistence: Events persist across browser sessions
- Node.js (v16 or higher)
- npm or yarn package manager
-
Clone the repository
git clone <repository-url> cd calendar-app
-
Install dependencies
npm install
-
Start the development server
npm run dev
-
Open your browser Navigate to
http://localhost:5173to view the application
npm run buildThe built files will be available in the dist directory.
- Click the "Event" button in the toolbar
- Or click on any time slot in the calendar
- Fill in the event details:
- Name: Event title (required)
- Start/End Time: Date and time selection
- Category: Work, Personal, Meeting, or Reminder
- Description: Optional event details
- Click "Save Event" to create
- Day/Week Toggle: Switch between day and week views
- Navigation Arrows: Move between time periods
- Today Button: Jump to the current date
- Month Picker: Click the month/year to open calendar picker
- Use the search bar in the sidebar
- Search by event name, date, or time
- Results update in real-time as you type
- Click the import button (upload icon)
- Select an ICS calendar file
- Events will be imported automatically
- Theme Colors: Modify Tailwind CSS classes in components
- Date Format: Adjust date-fns formatting in utility functions
- Categories: Add new event categories in the types file
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request