Skip to content

Maamoun0/TaskFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TaskFlow: Productivity Reimagined ⚡

A personal project by Ahmed Maamoun Solving the friction between complex task management and speed.


💡 Why I Built This?

I've always felt that most task managers are either too simple (to-do lists) or too bloated (Jira). I wanted to build something in the middle: a tool that feels instant. No loading spinners, no lag. Just pure focus. TaskFlow is the result of that experimentation with "Optimistic UI" and real-time syncing.


📸 Visual Tour

Landing Page Experience The Core Dashboard

🛠 What's Under the Hood?

Instead of just listing technologies, here is how they work together:

  • Next.js & TypeScript: The backbone that ensures everything is type-safe and fast.
  • Prisma & PostgreSQL: Handling complex relations between users and tasks without the headache of manual SQL.
  • Tailwind CSS: Custom-crafted dark mode and glassmorphism components.

🧠 Engineering Journal: The "Lag-Free" Challenge

The biggest hurdle was the Drag & Drop experience. When you move a task, the last thing you want is to wait for a database confirmation.

I solved this by building a custom Optimistic State Hook. The moment you drop a task, the UI updates locally and reorders the array. The API call happens in the background. If it fails (e.g., internet drop), I built a reconciliation logic that snaps the task back to its original place with a subtle "Error" shake animation. It makes the app feel like it's running at the speed of thought.


🚦 Getting Started (The Human Way)

  1. Clone it: git clone https://github.com/Maamoun0/TaskFlow.git
  2. Docker Magic: Just run docker-compose up -d and let the containers handle the database setup for you.
  3. Explore: Open localhost:3000 and start being productive.

👨‍💻 Get in Touch

Ahmed Maamoun - LinkedIn | GitHub

Hand-crafted with surgical precision.

About

Modern Full-Stack Task Management System built with Next.js, Express, and Prisma

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors