Semester Calendar Builder

A calendar builder for managing your semester schedule with support for courses, study blocks, and important dates.

Features

• Visual Weekly Calendar - Drag-and-drop interface with time blocks
• Multiple Event Types - In-person classes, online classes, study blocks, and exams
• Bulk Import/Export - CSV, ICS (iCalendar), and text formats
• Important Dates - Track deadlines, exams, and breaks
• PNG Export - Generate shareable schedule images
• Dark Mode - Beautiful Rose Pine night theme
• Mobile Responsive - Works seamlessly on all devices
• Local Storage - Your data never leaves your device
• Guided Onboarding - Load a sample semester and follow quick tips right in the app

Getting Started

Prerequisites

• Bun 1.0+ (recommended) or Node.js 18+

Installation

# Clone the repository
git clone <repository-url>
cd Semester-calender-builder

# Install dependencies
bun install

# Start development server
bun run dev

Open http://localhost:3000 to see your calendar.

Build for Production

# Create optimized production build
bun run build

# Start production server
bun run start

Usage

Quick Start

• Open the app and click Load Example Semester in the onboarding banner.
• Explore the sample classes, study blocks, and key academic dates.
• Replace events with your real schedule or import a CSV/ICS file via Manage Data.
• Your changes are stored locally, so you can experiment without losing anything.

Adding Events

1. Click "Add Event" button
2. Choose event type (Course, Study Block, Exam)
3. Fill in details (time, location, etc.)
4. Save to calendar

Bulk Import

1. Click "Manage Data" → "Bulk Input"
2. Paste schedule in supported format: CS101 | Intro to Programming | Mon,Wed | 09:00-10:30 | Room 101 MATH201 | Calculus II | Tue,Thu | 13:00-14:30 | Online
3. Events automatically populate

Exporting

• ICS: Import into Google Calendar, Outlook, Apple Calendar
• CSV: Open in Excel/Sheets for further editing
• PNG: Share schedule as an image
• Text: Copy formatted text summary

Contributing

This is a personal project, but suggestions are welcome! Please open an issue to discuss changes.

License

MIT License - See LICENSE file for details