A minimal, offline-first weekly study planner that runs entirely in the browser. All data is saved to localStorage — no accounts, no servers, no tracking.
- Daily / Weekly / Monthly views — switch between layouts depending on how you want to plan
- 10-minute time grid — visually block out study sessions from 6 AM to midnight
- Weekly to-do sidebar — track tasks alongside your schedule
- Week goals and reviews — set intentions and reflect at the end of each week
- Themes — 6 built-in color themes (Campus Blue, Sakura Pink, Matcha Green, Lavender, Sunset Orange, Monochrome)
- Import / Export — back up your data as JSON or export to CSV
- Print-friendly — print any view directly from the browser
- Fully offline — no internet required after the initial load
- React 18 + TypeScript
- Vite
- Tailwind CSS + shadcn/ui
- date-fns
This project is designed to be forked and deployed as a personal tool. Here's how:
Click the Fork button at the top right of this page.
Go to your fork's Settings > Pages and set the source to GitHub Actions.
That's it — the included workflow will automatically build and deploy on every push to main. Your planner will be live at:
https://<your-username>.github.io/study-planner/
If you rename your fork (e.g. to my-planner), update the base path in vite.config.ts:
base: "/my-planner/",git clone https://github.com/<your-username>/study-planner.git
cd study-planner
npm install
npm run devThe dev server runs at http://localhost:8080.
npm run buildOutput goes to dist/ — serve it with any static file host.
All data lives in your browser's localStorage under keys like planner-2026-W12. Nothing is sent anywhere. Use the export feature to back up your data or move it between browsers.
MIT