An AI-powered weekly planner that generates optimized schedules around your fixed commitments.
Tell it your prayers, classes, tasks, and goals - GPT builds a realistic week that respects every constraint.
Manually scheduling a productive week is painful. You have fixed commitments (classes, prayers, meetings) scattered across the day, a pile of tasks with different frequencies, and limited energy windows. Most planners make you do the puzzle yourself.
PlanGPT sends your full context - fixed blocks, task pool, frequencies, energy patterns - to GPT-4o, which returns an optimized 7-day schedule. You review, drag-and-drop to adjust, lock what you like, and regenerate the rest.
| Feature | Description |
|---|---|
| AI Schedule Generation | GPT-4o builds a full week in one shot, respecting all constraints |
| Smart Constraints | Fixed prayer times, class blocks, wake/sleep windows, transition buffers |
| Frequency Distribution | Tasks spread across the week (e.g., "5x/week" gets placed on 5 different days) |
| Drag & Drop | Reorder blocks within any day - times auto-recalculate |
| Day Locking | Lock completed days so mid-week regeneration only touches unlocked ones |
| Completion Tracking | Check off blocks as you go, with daily progress bars |
| In-Place Editing | Click any block title to rename it |
| Weekly History | Archives up to 8 previous weeks with completion data |
| Sunday = Rest | Enforced rest day - only prayers, Quran, and relaxation |
| Local Persistence | Everything stored in localStorage - no account needed |
Setup Mode --> GPT-4o API --> Week View
Define tasks 200-line prompt 7-column calendar
Set frequencies with constraints Drag & drop
Fixed blocks Returns JSON Track completion
- Setup - Add your tasks with duration, frequency, and category
- Generate - One click sends everything to GPT-4o with detailed scheduling rules
- Review - See your full week laid out with color-coded categories
- Adjust - Drag blocks, edit titles, lock days you're happy with
- Track - Check off completed blocks throughout the week
| Category | Color | Examples |
|---|---|---|
| Prayer | Lime | Fajr, Dhuhr, Asr, Maghrib, Isha |
| Class | Blue | University lectures (Mon-Fri) |
| Growth | Purple | Quran journal, English practice, reading |
| Outreach | Cyan | LinkedIn, cold outreach, content creation |
| Work | Orange | Client projects, freelance tasks |
| Break | Gray | Meals, rest, transition buffers |
- Node.js 18+
- OpenAI API key
git clone https://github.com/CodeWithArhum/TimeTable-AI.git
cd TimeTable-AI
npm installCreate .env.local:
OPENAI_API_KEY=your_openai_api_keynpm run dev| Layer | Technology |
|---|---|
| Framework | Next.js 14 (App Router) |
| Language | TypeScript 5 |
| Styling | Tailwind CSS 3.4 |
| AI | OpenAI SDK (GPT-4o, GPT-4 Turbo, GPT-3.5) |
| Drag & Drop | dnd-kit |
| Icons | Lucide React |
| Storage | localStorage (no backend DB) |
| Rate Limiting | LRU Cache (3 req/min per IP) |
TimeTable-AI/
├── src/app/
│ ├── page.tsx # Main app (setup + week view, 930 lines)
│ ├── layout.tsx # Root layout with metadata
│ ├── globals.css # Tailwind + custom animations
│ ├── api/generate/
│ │ └── route.ts # OpenAI API handler + prompt engineering
│ └── fonts/ # Geist font files
├── tailwind.config.ts # Extended color palette
├── next.config.mjs # Security headers (CSP, X-Frame-Options)
└── package.json
- Rate limited to 3 generations per minute per IP
- CSP headers configured in
next.config.mjs - API key stays server-side (never exposed to client)
- Input validation on task count and model selection
Built by @CodeWithArhum