Skip to content

aychew1229/EduPlan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📚 EduPlan — Smart Timetable Planner

A production-ready academic planner built for Ethiopian university students.
Featuring a dual-calendar system (Gregorian + Ethiopian EC), Pomodoro timer, conflict detection, and offline-first local storage.

EduPlan Preview Made for Ethiopia

Launch Live 🚀


✨ Features

🗓️ Smart Schedule

  • Interactive weekly timetable grid (Mon–Sat, 7 AM–9 PM)
  • Color-coded class types: Lecture, Lab, Tutorial, Sport, Other
  • Click any slot to add a class; hover to edit or remove
  • Automatic conflict detection with visual warnings
  • Export to .ics (Google Calendar / Outlook / Apple Calendar)

⏰ Deadlines & Assignments

  • Track Exams, Assignments, Quizzes, Projects, and Study Goals
  • Filter by type with one click
  • Mark as done with a single tap
  • Auto-reminders that appear as deadlines approach

🇪🇹 Ethiopian Calendar Integration

  • Accurate GC → EC conversion (verified against official Ethiopian calendar)
  • Live EC date preview when picking a due date
  • Every deadline card shows both Gregorian and Ethiopian dates side by side

⏱️ Pomodoro Study Timer

  • Modes: Pomodoro (25 min), Deep Work (50 min), Short Focus (15 min), Breaks
  • Auto-logs completed sessions with Ethiopian date/time
  • Daily progress bar towards a 4-session goal
  • Desktop notifications when session ends

🔔 Smart Reminders

  • Auto-generated from deadlines (1 day / 3 days / 1 week before)
  • Custom reminders with date and time
  • Dismiss or restore any reminder
  • Badge count on nav tab

🔐 Multi-User Auth

  • Register/login with username + PIN (stored locally)
  • Per-user data isolation — each user has their own planner
  • Session persists across browser restarts

📱 Fully Responsive

  • Desktop: full sidebar navigation
  • Mobile: bottom tab bar with badge indicators
  • Works on any screen size

🛠️ Tech Stack

Technology Purpose
HTML5 Structure
CSS3 (Custom Properties) Styling, animations, responsive layout
Vanilla JavaScript (ES6+) All logic — no frameworks, no dependencies
localStorage Offline-first data persistence
Web Notifications API Study session alerts

Zero dependencies. No npm. No build step. Just one HTML file.

🔒 Privacy

All data is stored in your browser's localStorage. Nothing is sent to any server. Clearing browser data will erase your planner — export your schedule as .ics or .csv to back it up.


👤 Author

Aychew M.: Electrical & Computer Engineering Student
Debre Tabor University, Ethiopia

Portfolio GitHub


📄 License

Open Source License — free to use, modify, and distribute.


Made with ❤️ in Ethiopia 🇪🇹

About

Smart academic planner for Ethiopian university students weekly timetable, Ethiopian calendar (EC) integration, Pomodoro timer, deadline tracker, and conflict detection. Zero dependencies, offline-first.Topics to add: ethiopian-calendar timetable student-planner pomodoro html javascript github-pages ethiopia

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors