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.
Username/password and Google sign-in flows, email OTP verification and a playful 3D welcome.
|
Pending, due today, completed and overdue counts put the next step in view.
|
Search and filter your tasks, check off a step and follow completion by category.
|
Original application captures. Select any screenshot to inspect it at full resolution.
| 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. |
| 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 |
%%{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
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.
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 .venvActivate 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 requests2. Connect the database and services
- Import the compatible schema into MySQL and update
DB_CONFIGin db.py. The current defaults use databasetodolistand port 4306; set the host, port and credentials for your instance. - Create
client_secret.jsonin 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_IDin useGoogleAuth.js with your Google web client ID and configurehttp://localhost:5173as an authorized JavaScript origin.
3. Start both servers from the repository root
# Terminal 1 — Python environment activated
python backend.py
# Terminal 2
npm run devOpen 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


