TaskFlow

TaskFlow is a Next.js project management workspace with Supabase-backed auth/data, guarded login via ALTCHA, and in-app ML features for prioritization, assignment, wellness, and bottleneck analysis.

Current App Surface

• Public landing page at /
• Guided Supabase credential setup at /setup
• ALTCHA-gated auth at /login
• Authenticated home at /dashboard
• Team management at /team
• Workspace settings and local Env Vault at /settings
• Per-project workspace at /projects/[id]

Inside a project, the current UI includes:

• Kanban board
• Backlog
• Calendar
• Timeline
• Summary and reports
• Team chat and direct messages
• Time tracking
• Forms builder and responses
• Pages/documents
• Shortcuts
• Code/repository links
• Deployments
• Video room
• ML recommendations and bottleneck alerts

Tech Stack

Layer	Technology
Framework	Next.js 16 App Router
UI	React 19, TypeScript, Tailwind CSS
State/Contexts	Custom React contexts for auth, theme, and timers
Data/Auth	Supabase
CAPTCHA	ALTCHA
ML	In-app TypeScript engine plus @xenova/transformers
Charts	Recharts
Motion	Framer Motion
Drag and Drop	@dnd-kit/*
Icons	Lucide React

Main Features

Authentication and Access

• Email/password sign-up and sign-in
• Google and GitHub OAuth
• ALTCHA verification required before auth actions
• Shared authenticated layout that routes signed-in users into the workspace
• Role-aware user and project management flows

Project Operations

• Project creation and membership management
• Task CRUD with comments, priorities, assignees, tags, due dates, and status updates
• Kanban, backlog, calendar, and timeline views
• Notifications, activity feed, and per-user history
• Direct messages, project room chat, replies, reactions, and attachments
• Time entry and time-tracking summaries

AI and ML

• Browser-side draft assistance through lib/ml-browser.ts
• Server-side scoring and analytics through lib/ml-engine.ts
• Transformer-based assignment analysis through lib/ml-transformers.ts
• Priority prediction
• Assignment recommendations
• Bottleneck detection
• Workload and wellness analysis
• Task clustering and recommendation endpoints

Settings and Developer Workflow

• Workspace settings for profile, theme, AI preferences, notifications, and security
• Frontend-only local Env Vault in settings, encrypted with Web Crypto and stored in device local storage
• Guided /setup page for validating Supabase credentials before login
• API routes for projects, tasks, comments, forms, documents, notifications, meetings, GitHub data, ML, and admin checks

Project Structure

task-flow/
|- app/                    # App Router pages and route handlers
|  |- api/                 # Backend endpoints used by the app UI
|  |- dashboard/           # Authenticated dashboard
|  |- login/               # ALTCHA-gated authentication
|  |- projects/[id]/       # Per-project workspace
|  |- settings/            # Workspace settings and local Env Vault
|  |- setup/               # Supabase onboarding flow
|  `- team/                # Team management
|- components/             # UI views, layout, modals, forms, charts
|- contexts/               # Auth, theme, and timer providers
|- lib/                    # Supabase client, DB access, ML logic, utilities
|- public/                 # Static assets
|- types/                  # Shared TypeScript declarations
`- ML/                     # Legacy Python experiments and archived model assets

Environment Variables

Create a .env.local file in the project root:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
ALTCHA_HMAC_SECRET=your_altcha_hmac_secret
ALTCHA_HMAC_KEY_SECRET=optional_altcha_key_secret

Optional variables may still be useful depending on the flows you use:

• NEXT_PUBLIC_SITE_URL for explicit site URL resolution in auth redirects
• NEXT_PUBLIC_VERCEL_URL when running on Vercel
• SMTP-related variables if you wire up email delivery for OTP/member notifications

Getting Started

Prerequisites

• Node.js 18+
• npm
• A Supabase project with the tables/RPCs this app expects

Install

npm install

Run the app

npm run dev

Open http://localhost:3000.

Recommended first-run flow:

1. Add the required variables to .env.local.
2. Start the dev server.
3. Open /setup to validate the Supabase URL and anon key.
4. Apply the SQL you need in your Supabase project.
5. Continue to /login and sign in.

Database and Supabase Notes

• Runtime Supabase access lives in lib/supabase.ts.
• The repository still contains a top-level supabase/ folder for migration/history material when present locally, but the app runtime depends on the client/config in lib/, not on that folder itself.
• The checked-in .gitignore currently ignores /supabase, so migration files may exist locally without being committed.
• Auth redirect URL resolution is handled through lib/site-url.ts.

ML Runtime Notes

• The live app does not require a separate Python ML server.
• Current runtime ML paths are TypeScript-based and live under lib/.
• The ML/ directory is legacy research/training material, not part of the current Next.js runtime.
• next.config.ts explicitly allows external server packages needed by the transformer/ONNX path.

Scripts

npm run dev
npm run build
npm run start
npm run lint

Known Repo Notes

• npm run lint may be noisy if local repo state references paths that are no longer present.
• The settings Env Vault is frontend-only and stores encrypted values in local browser storage on the current device.
• Some helper/setup copy in the UI still assumes a local open-source/self-hosted style workflow around Supabase credentials.

License

MIT