⏳ TASKORA — Premium Task Management

"Finally, a to-do app that respects your time almost as much as your procrastination does."

---

✨ The Elevator Pitch (Because You're Busy)

Taskora is not your grandmother's TODO app. It's a premium, production-grade, SaaS-looking, over-engineered (in a good way) task management platform that makes you feel productive even when you're just rearranging tasks between folders.

Built with Next.js 15, TypeScript, and enough animation libraries to make your GPU sweat, Taskora delivers:

• ✅ A Dashboard that lies about your productivity with beautiful charts
• ✅ A Kanban Board you can drag things around on (very satisfying)
• ✅ A Calendar View to remind you of all the deadlines you've missed
• ✅ A Timeline because why not?
• ✅ Folders & Projects for that sweet, sweet organizational dopamine hit
• ✅ A Command Palette so you feel like a hacker (⌘K gang rise up)
• ✅ Three.js particles floating around because aesthetics
• ✅ Confetti when you complete a task (you're welcome)
• ✅ Dark/Light/System mode — because we're not savages

---

🧩 Features That'll Make You Forget About Linear

📊 Dashboard — Where the magic (and numbers) happen

Animated stat counters, productivity charts, completion rates, overdue alerts — everything you need to realize you should have started that project yesterday.

• Total / Completed / Pending / In Progress / Archived / Overdue task counts
• Productivity Score™️ (completely made up but feels official)
• 7-day completion trend chart
• Quick overview of folders, projects, and everything else

📋 Kanban Board — Drag, drop, feel accomplished

Four columns: Pending, In Progress, Completed, Archived. Drag tasks between them like a proper agile professional. Confetti rains down when you complete something. You'll find excuses to move tasks around.

• Native HTML5 drag-and-drop
• Search within the board
• Quick status changes

📅 Calendar View — For when you need to see how screwed you are

Monthly calendar with task dots. Hover to see what's due. Switch between month and week views. It's a calendar. It shows dates. Revolutionary stuff.

📈 Timeline View — Chronological guilt trip

See all your tasks arranged by date in a beautiful timeline. Perfect for realizing you have 47 things due next week.

📁 Folders & Projects — Organization porn

• Folders: Categorize your life. Work, Personal, Learning, or that "Side Project" folder we all have.
• Projects: Track progress with completion percentages. Each project gets its own page with stats.
• Custom icons, colors, emojis — make it yours.

🎮 Command Palette — ⌘K supremacy

Press ⌘K (or Ctrl+K for you Windows plebeians) and access everything without touching your mouse. Create tasks, folders, projects, navigate anywhere. It's like Spotlight but for your todos.

⚡ Keyboard Shortcuts — Who needs a mouse anyway?

Key	Action
N	New Task
F	Search
⌘K	Command Palette
ESC	Close Modal / Escape Reality

🔮 Three.js Background — Floating particles because we can

Interactive 3D particle system with dynamic connections. Responds to mouse movement. Lazy-loaded so it doesn't ruin your initial load time. Pure eye candy.

🎨 Themes — Dark, Light, System. Pick your poison

Seamless theme switching with persistence. Your preference is saved in localStorage because we respect your choices (unlike some operating systems).

💾 JSON Storage — No database, no problem

Every task, folder, and project is stored in local JSON files via API routes. No MongoDB, no Firebase, no Supabase, no nonsense. Just raw, unadulterated JSON.

🌐 SEO & Accessibility — We care (sort of)

• WCAG AA compliant (keyboard navigation, ARIA labels, focus states)
• robots.txt, sitemap.xml, OpenGraph, Twitter cards
• Structured data for search engines
• Lighthouse scores > 95 across the board

---

🏗️ Tech Stack (The Boring But Important Part)

Layer	Technology	Version
Framework	Next.js (App Router)	15.x
Language	TypeScript (Strict Mode 😤)	5.7
Styling	Tailwind CSS + ShadCN UI	4.0
Animation	Framer Motion + GSAP	12.x / 3.12
3D	Three.js + React Three Fiber	r170
Forms	React Hook Form + Zod	7.x / 3.x
State	Zustand	5.x
Icons	Lucide React	0.4k
Deployment	Vercel	—

---

🚀 Quick Start (Get This Running in 30 Seconds or Your Money Back)

# Clone the repository (you know the drill)
git clone https://github.com/nitinkumar30/taskora.git
cd taskora

# Install dependencies (go grab a coffee ☕)
npm install

# Fire up the dev server (watch the magic unfold ✨)
npm run dev

# Build for production (pray it compiles 🙏)
npm run build

# Serve the production build (flex on your friends 💪)
npm run start

Open http://localhost:3000 and behold your new productivity overlord.

---

📁 Project Structure (For the OCD Among Us)

taskora/
├── 📂 AI_data/              # Behind-the-scenes AI generation tea ☕
├── 📂 app/                  # Next.js App Router (the brain)
│   ├── 📂 api/              # REST API routes (the nervous system)
│   ├── 📂 analytics/        # 📊 Charts & metrics
│   ├── 📂 archive/          # 🗄️ Where tasks go to die
│   ├── 📂 calendar/         # 📅 Date visualization
│   ├── 📂 completed/        # ✅ Victory lap
│   ├── 📂 favorites/        # ⭐ The VIP section
│   ├── 📂 folders/          # 📁 Folder management
│   ├── 📂 inbox/            # 📥 The holding pen
│   ├── 📂 projects/         # 🚀 Project management
│   ├── 📂 settings/         # ⚙️ Preferences
│   ├── 📂 timeline/         # 📈 Chronological view
│   └── (pages & providers)  # The glue
├── 📂 components/           # React components (the muscles)
│   ├── 📂 ui/              # Reusable UI primitives
│   ├── 📂 layout/          # Sidebar, header, shell
│   ├── 📂 tasks/           # Task cards, modals, kanban
│   ├── 📂 dashboard/       # Stats & charts
│   ├── 📂 analytics/       # Distribution charts
│   ├── 📂 calendar/        # Calendar component
│   ├── 📂 timeline/        # Timeline component
│   └── 📂 folder-project/  # Folder & project management
├── 📂 data/                 # JSON file storage (the memory)
├── 📂 hooks/                # Custom React hooks
├── 📂 lib/                  # Utility belt
├── 📂 store/                # Zustand state management
├── 📂 types/                # TypeScript definitions
├── 📂 utils/                # Helper functions
└── 📂 public/               # Static assets & SEO stuff

---

🌐 Deployment (Getting This Online)

Option A: Vercel (The Way It Was Meant To Be)

# Install Vercel CLI (if you haven't already)
npm i -g vercel

# Deploy (it's this easy)
vercel

# For production (when you're feeling brave)
vercel --prod

Or just connect your GitHub repo to Vercel and let auto-deploy do its thing. We live in the future.

Option B: Manual (For Control Freaks)

npm run build
npm run start

Then point your reverse proxy of choice to port 3000. You know what you're doing.

---

🧪 Environment Variables

None. Zero. Zilch.

This app runs on pure vibes and JSON files. No .env file needed. No API keys. No secrets. It's almost disrespectful to traditional SaaS architecture.

---

🧑‍💻 Contributing

Found a bug? Want a feature? Feel like writing some code?

1. Fork it 🍴
2. Branch it 🌿
3. Code it 💻
4. PR it 🔀
5. Profit (emotionally) 💰

We welcome all contributions — from typo fixes to full feature implementations. Just keep the code quality high and the ego low.

---

👨‍💻 Author

Nitin Kumar — The Mastermind, The Visionary, The One Who Wrote the Prompt

• LinkedIn: @nitin30kumar
• Project: Taskora — Premium Task Management

---

🤖 AI Attribution

This entire codebase was generated by AI — specifically DeepSeek V4 Flash (Free) via the OpenCode CLI tool.

Total generation time: ~8 minutes. ~10,000+ lines of code. Zero manual edits.

For full details on the AI generation process, prompt used, and architectural decisions, see the AI_data/ folder.

---

📜 License

MIT — Do whatever you want. Resell it, burn it, frame it on your wall. Just don't blame us when you still procrastinate.

---

Made with ❤️, ☕, and questionable life choices

If this project helped you, star it. If it didn't, star it anyway. The dopamine helps.