Skip to content

About

TaskFlow : Full-stack task, meeting & project management SPA — React (Vite) + Flask + MySQL, with Google OAuth, OTP verification, and a glassmorphism UI

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

✦ Overview

"Three apps for one workday is two too many."

TaskFlow began in early 2025 as a humble to-do list inspired by tools like ClickUp, and grew into a single, cohesive workspace where tasks, meetings, and multi-person projects live side by side.

It isn't a CRUD demo wearing a costume. TaskFlow ships with its own design language, built to feel like a real product from the first screen:

🪟 Glass

A glassmorphism UI with frosted panels, soft depth and luminous gradients.

🌗 Dual-theme

Full dark / light parity on every screen, not just the landing page.

🧊 Playful 3D

Draggable 2.5D / 3D characters powered by Three.js and react-three-fiber.

✦ Gallery

Every screen below is real, shipped UI — click a section to expand it.

🔐  Authentication  ·  Google OAuth 2.0, email & password, 6-digit OTP
Sign in — dark mode Sign in — light mode
Sign in — identical experience in dark and light

Email OTP verification
Email verification — a clean, step-based 6-digit OTP flow
📊  Dashboard  ·  stats, live task creation, progress ring
Dashboard — dark theme
Dark

Dashboard — light theme
Light

At-a-glance counters for pending · due today · completed · overdue, a live task-creation form, and a progress ring that updates in real time.

🗓️  Calendar  ·  tasks, project work & meetings in one view
Calendar view
Monthly view with an illustrated character guide & legend

Calendar — task detail Calendar — meeting detail
Task detail  ·  Meeting detail — steps, agenda & location, without leaving the calendar

Calendar metadata panel
Metadata panel
📁  Projects  ·  a guided two-step creation flow
Create project — step 1 Create project — step 2
Step 1 — name, description, cover  ·  Step 2 — invite your team
🔔  Notifications  ·  a proper inbox, not an afterthought
Notifications panel
Unread counts · mark-as-read · mark-all-read — from the bell in the top nav

✦ Features

🔐 Secure Authentication

Google OAuth 2.0, email OTP verification, and a guided multi-step profile setup.

✅ Task Management

Create, update and complete tasks with steps, priorities, categories and due dates.

🤝 Meeting Management

Schedule meetings with locations, participants and agendas, plus map-based venues.

📁 Project Collaboration

Spin up projects and invite collaborators with invitation codes.

🔔 Notification System

Automated in-app reminders for upcoming and overdue items.

📧 Email Notifications

Optional automated email delivery for key updates.

🗺️ Map Integration

Embedded Leaflet maps for geocoded meeting locations.

🎨 Theming  +  🧊 3D / 2.5D Visuals

Full dark/light mode on every screen, and interactive, draggable animated elements built with Three.js & react-three-fiber.

✦ Architecture

%%{init: {'theme':'base','themeVariables':{
  'primaryColor':'#1b1245','primaryTextColor':'#e0e7ff','primaryBorderColor':'#a78bfa',
  'lineColor':'#7dd3fc','secondaryColor':'#0a2a4a','tertiaryColor':'#0b0820',
  'fontFamily':'ui-sans-serif, system-ui'}}}%%
flowchart LR
  subgraph FE["⚛️  React (Vite) SPA"]
    direction TB
    R["React Router"]
    H["12+ Custom Hooks<br/><sub>useDashboardData · useCalendarTasks · useNotifications</sub>"]
    UI["Glass UI · Three.js · Leaflet"]
    R --> H --> UI
  end

  subgraph BE["🐍  Flask Backend"]
    direction TB
    BP["Blueprints<br/><sub>auth · tasks · meetings · projects · notifications</sub>"]
    SA["Session Auth<br/><sub>Google OAuth 2.0 · Email OTP</sub>"]
    BP --- SA
  end

  DB[("🗄️  MySQL")]

  FE == "JSON / REST · 20+ endpoints" ==> BE
  BE == "queries" ==> DB
  BE -. "responses" .-> FE

  classDef box fill:#1b1245,stroke:#a78bfa,color:#e0e7ff,stroke-width:1.5px;
  class R,H,UI,BP,SA,DB box;
Loading

⚛️ Frontend

A Vite-powered SPA with client-side routing. A library of 12+ custom hooks decouples data-fetching, derived state and UI logic.

🐍 Backend

Flask organized into blueprints, exposing 20+ REST endpoints across auth, tasks, meetings, projects and notifications.

🗄️ Data & Auth

MySQL with a centralized connection/config module. Session-based auth with Google OAuth 2.0 and email OTP as alternate flows.

✦ Tech Stack

Layer Tools
Frontend React Vite React Router Three.js react-three-fiber Leaflet
Backend Flask Python Werkzeug
Database MySQL
Auth Google Sessions OTP

✦ Roadmap

TaskFlow is an evolving MVP. What's next:

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#1b1245','primaryTextColor':'#e0e7ff','primaryBorderColor':'#a78bfa','lineColor':'#7dd3fc','fontFamily':'ui-sans-serif, system-ui'}}}%%
mindmap
  root((TaskFlow<br/>next))
    Collaboration
      📝 Collaborative document editor
      📎 File sharing in Meetings
    Intelligence
      🤖 AI-assisted productivity suggestions
    Reach
      📱 Push notifications to devices
Loading
  • 📝 Collaborative document editor for multi-person project work
  • 📎 File sharing within the Meeting module
  • 🤖 Personalized AI-assisted productivity suggestions
  • 📱 Push notifications to user devices

✦ License

Released under the MIT License — build on it, remix it, make it yours.


Crafted with ❤️ and a lot of ☕ by thonedra-dev

If TaskFlow inspires you, a ⭐ goes a long way.



About

TaskFlow : Full-stack task, meeting & project management SPA — React (Vite) + Flask + MySQL, with Google OAuth, OTP verification, and a glassmorphism UI

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages