Skip to content
thonedra-devPublic

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

TaskFlow — Your work. Your team. One flow. A workspace for tasks, meetings and projects.

Experience · Capabilities · Run locally

TaskFlow brings tasks, meetings and projects into one expressive workspace. Plan your day, break work into steps and bring teammates into your projects through connection codes and invitations.

Experience

01 / A welcoming way in

Username/password and Google sign-in flows, email OTP verification and a playful 3D welcome.


TaskFlow dark-mode sign-in screen with username and password fields, a Google sign-in button and a 3D character

02 / Give your day some clarity

Pending, due today, completed and overdue counts put the next step in view.


TaskFlow light-mode dashboard showing task summary cards, the new-task form and a progress panel

03 / Watch the work add up

Search and filter your tasks, check off a step and follow completion by category.


TaskFlow light-mode task list with search, date filters, priority labels, completion progress and category totals

Original application captures. Select any screenshot to inspect it at full resolution.

Capabilities

Plan with purpose Keep the context
Tasks & steps — priorities, categories, due dates and completion. Meetings & maps — agendas, online links and mapped venues.
Calendar — monthly tasks and meetings with detail panels. Project invitations — find teammates by code; accept or decline invites.
Visible progress — completion rings and category totals. Personal touches — theme switching, interactive 3D and a notification inbox.

Built with

Layer Technology
Interface React 19 · Vite 8 · React Router 7
API Python · Flask · Flask-CORS · Werkzeug
Data MySQL · MySQL Connector/Python
Interaction Three.js · React Three Fiber · Drei · React Leaflet
Identity & email Google Identity Services · Flask sessions · Gmail SMTP

One workspace, three layers

%%{init: {"flowchart": {"rankSpacing": 24, "padding": 12}, "themeVariables": {"fontSize": "20px"}}}%%
flowchart LR
  UI["React"] <-->|"/api"| API["Flask"]
  API <-->|"SQL"| DB[(MySQL)]
  classDef layer fill:#1a223d,stroke:#8576cc,color:#eef0ff
  class UI,API,DB layer
Loading

React hooks use a shared fetch helper with session cookies. Flask routes cover tasks, meetings and notifications; the user blueprint covers accounts, profiles and project invitations. db.py centralizes MySQL connections. During development, Vite forwards /api and /static to Flask.

Run locally

Prerequisites: Node.js 22.12+, Python 3 and MySQL.

Database required: This repository does not include schema SQL or a database bootstrap script. Obtain a compatible todolist schema from the maintainer before running the full application.

Configure and start your workspace

1. Install the dependencies

git clone https://github.com/thonedra-dev/TaskFlow.git
cd TaskFlow
npm ci
python -m venv .venv

Activate the Python environment with .\.venv\Scripts\Activate.ps1 in PowerShell, or source .venv/bin/activate on macOS/Linux, then install the backend dependencies:

python -m pip install Flask Flask-Cors mysql-connector-python requests

2. Connect the database and services

  • Import the compatible schema into MySQL and update DB_CONFIG in db.py. The current defaults use database todolist and port 4306; set the host, port and credentials for your instance.
  • Create client_secret.json in the repository root with the structure below. user.py reads it at startup. The file is ignored by Git; Gmail credentials are needed for OTP and account email delivery.
{
  "app": {
    "sender_email": "you@gmail.com",
    "sender_password": "YOUR_GMAIL_APP_PASSWORD",
    "upload_folder": "static/uploads/profile_pics"
  }
}
  • For Google sign-in, replace GOOGLE_CLIENT_ID in useGoogleAuth.js with your Google web client ID and configure http://localhost:5173 as an authorized JavaScript origin.

3. Start both servers from the repository root

# Terminal 1 — Python environment activated
python backend.py

# Terminal 2
npm run dev

Open http://localhost:5173/auth. Flask listens on http://localhost:5000. npm run build builds the frontend; Flask does not currently serve that build.

On case-sensitive filesystems, match the WelcomePopup import in LoginRegister.jsx to the existing filename, Welcomepopup.jsx.

This is a development project: Flask uses debug mode and a placeholder session secret, and the Google flow still needs server-side credential verification before deployment.


TaskFlow · Designed and built by thonedra-dev

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