Skip to content

SriramDivi1/TaskFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“± TaskFlow

Your Beautiful, Modern Task Management Companion

A stunning, mobile-first task management app built with cutting-edge web technologies. Manage tasks, track progress, and collaborate with your team β€” all in a gorgeous interface that feels like a native mobile app.

TaskFlow Splash

React TypeScript Zustand Tailwind CSS Vite

Live Demo β€’ Features β€’ Installation β€’ Screenshots


🌟 Why TaskFlow?

TaskFlow isn't just another task manager β€” it's a beautifully crafted experience that combines modern design with powerful functionality. Built from the ground up with React and TypeScript, it offers:

  • 🎨 Stunning UI β€” Glassmorphism effects, smooth animations, and a delightful user experience
  • πŸ“± Mobile-First β€” Feels like a native app with no visible scrollbars and fluid transitions
  • πŸ’Ύ Smart Persistence β€” Your data is automatically saved and synced to local storage
  • ⚑ Lightning Fast β€” Powered by Vite and optimized for performance
  • 🎯 Zero Learning Curve β€” Intuitive interface that anyone can use immediately

✨ Features

🎯 Task Management Excellence

  • βœ… Create, edit, delete, and complete tasks with ease
  • 🏷️ Organize by categories (Marketing, Family, Sports, Academics, etc.)
  • 🎨 Priority levels (High, Medium, Low) with visual color coding
  • πŸ“Š Progress tracking with beautiful progress bars
  • πŸ‘₯ Team collaboration with assignee management

πŸ“… Smart Organization

  • πŸ—“οΈ Interactive calendar view with monthly navigation
  • πŸ“ Calendar strip for quick date selection
  • πŸ” Powerful search with category filters
  • ⏱️ Time-based scheduling with start/end times
  • πŸ“ Detailed task descriptions and notes

πŸ’« Modern Experience

  • 🎭 Smooth animations powered by Motion/React
  • πŸ”” Toast notifications for instant feedback
  • 🌐 React Router for seamless navigation
  • πŸ’Ύ Zustand state management for optimal performance
  • 🎨 Glassmorphism and modern design patterns
  • πŸ“± No scrollbars β€” pure native app feel

πŸ“Έ App Showcase

πŸ” Authentication & Onboarding

Beautiful Sign In

🏠 Dashboard & Home

Home Dashboard with Tasks

βž• Create & Edit Tasks

Create New Task

πŸ” Search & Filter

Search Tasks

πŸ“… Calendar & Schedule

Calendar View

πŸ‘€ Profile & Settings

User Profile

πŸ“ Task Details

Task Details - In Progress Task Details - Completed

πŸš€ Quick Start

Prerequisites

  • Node.js 16+ and npm

Installation

# Clone the repository
git clone https://github.com/SriramDivi1/TaskFlow.git
cd TaskFlow

# Install dependencies
npm install

# Start development server
npm run dev

πŸŽ‰ Open http://localhost:3000 and start managing your tasks!


πŸ› οΈ Tech Stack

Core

  • React 18 β€” Latest React with hooks and concurrent features
  • TypeScript β€” Type-safe development
  • Vite β€” Next-generation frontend tooling

State & Routing

  • Zustand β€” Lightweight state management with persistence
  • React Router v7 β€” Client-side routing with browser history

Styling & UI

  • Tailwind CSS β€” Utility-first CSS framework
  • Motion (Framer Motion) β€” Smooth animations and transitions
  • Lucide React β€” Beautiful icon library

Developer Experience

  • date-fns β€” Modern date utility library
  • Sonner β€” Beautiful toast notifications
  • ESLint β€” Code quality and consistency

πŸ“¦ Project Structure

TaskFlow/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/           # React components
β”‚   β”‚   β”œβ”€β”€ Layout.tsx        # App layout wrapper
β”‚   β”‚   β”œβ”€β”€ BottomNav.tsx     # Bottom navigation
β”‚   β”‚   β”œβ”€β”€ HomeScreen.tsx    # Dashboard view
β”‚   β”‚   β”œβ”€β”€ CreateTaskScreen.tsx
β”‚   β”‚   β”œβ”€β”€ TaskDetailScreen.tsx
β”‚   β”‚   β”œβ”€β”€ SearchScreen.tsx
β”‚   β”‚   β”œβ”€β”€ CalendarScreen.tsx
β”‚   β”‚   β”œβ”€β”€ ProfileScreen.tsx
β”‚   β”‚   └── ui/               # Reusable UI components
β”‚   β”œβ”€β”€ store.ts              # Zustand store with persistence
β”‚   β”œβ”€β”€ types.ts              # TypeScript type definitions
β”‚   β”œβ”€β”€ data/                 # Mock data
β”‚   β”œβ”€β”€ App.tsx               # Root component with routing
β”‚   └── main.tsx              # Entry point
β”œβ”€β”€ screenshots/              # App screenshots
└── README.md                 # You are here!

🎨 Key Features Explained

πŸ”„ State Management with Zustand

// Centralized store with automatic persistence
const tasks = useStore((state) => state.tasks);
const addTask = useStore((state) => state.addTask);
  • Automatic localStorage sync
  • Custom Date serialization
  • No prop drilling
  • Type-safe actions

🧭 Smart Navigation

  • Browser back/forward button support
  • Meaningful URLs
  • Conditional bottom nav visibility
  • Smooth page transitions

πŸ’Ύ Data Persistence

  • Auto-save to localStorage
  • Survives page refreshes
  • State hydration on app load
  • No data loss

🎯 Use Cases

Perfect for:

  • πŸ“š Students managing assignments and study schedules
  • πŸ’Ό Professionals tracking work projects
  • πŸ‘¨β€πŸ‘©β€πŸ‘§β€πŸ‘¦ Families organizing household tasks
  • 🎯 Teams collaborating on projects
  • πŸ“… Anyone who wants beautiful task management

🀝 Contributing

Contributions are welcome! Feel free to:

  • πŸ› Report bugs
  • πŸ’‘ Suggest new features
  • πŸ”§ Submit pull requests
  • ⭐ Star this repository

πŸ“„ License

This project is open source and available under the MIT License.


πŸ‘¨β€πŸ’» Author

Sriram Divi
GitHub: @SriramDivi1


🌟 Love TaskFlow? Give it a star! ⭐

Made with ❀️ using React & TypeScript

⬆ Back to Top

About

A modern task management app built with React, TypeScript, and Tailwind CSS featuring intuitive UI, calendar integration, and comprehensive accessibility

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors