TaskHub

A focused workspace for projects, people, and the next thing to do.

Open TaskHub · Getting started · Architecture · User guide · Contributing

What you can do

• Organize projects, plan tasks, assign teammates, and track checklist progress.
• Switch between daily, weekly, and monthly schedules.
• Explore workload and export date-filtered reports as CSV or print/PDF.
• Invite collaborators, manage owner/admin/member permissions, and exchange private messages.
• Read activity notifications and restore completed or archived projects.
• Personalize your profile, avatar, theme, and accent color.

TaskHub uses real accounts. Settings offers an optional personal sample workspace with removable demo projects, tasks and checklist steps. Apply the demo migration first; see sample data.

Project story

TaskHub started during a development marathon. After the marathon, I continued developing it with a redesigned interface, expanded collaboration features, and a more maintainable architecture.

Built with intention

Experience	Implementation
A consistent workspace	Custom date/time controls, light and dark themes, accent colors
Real collaboration	Supabase Auth, row-level permissions, private conversations and unread counts
Clear planning	A full-day scrollable schedule, task steps and project lifecycle controls
Maintainable code	Small feature components, ordered CSS modules and documented data boundaries

Run locally

Requires Node.js 20.9+, Bun 1.3.14, and the configured Supabase schema.

bun install --frozen-lockfile
cp .env.example .env.local
# Add your Supabase project URL and public anon key.
bun dev

Open localhost:3000. Follow the setup guide for authentication, storage, and database requirements. The repository contains incremental migrations for an existing database, not a complete fresh-install baseline.

Documentation

Guide	Contents
Setup	Environment, authentication, migrations, local development
Architecture	Routing, component boundaries, data flow, CSS, dependencies
Database	Entities, permissions, RPCs, realtime, migration order
User guide	Projects, tasks, messaging, analytics, keyboard shortcuts
UI guidance	Design tokens, file limits, accessibility, shared help text
Contributing	Commands, review expectations, testing, upgrades
Deployment	Production configuration, validation, rollback

Quality checks

bun run check:structure
bun run typecheck
bun run lint
bun test
bun run build

Project history

Created during the RED Summer 2025 marathon and developed into a collaborative workspace by Mike Mazurkevich. Original visual inspiration: Task Management Web App.

Licensed under MIT.