Task Management App

Full-stack task management app with:

• Backend: NestJS + Prisma + PostgreSQL + Redis + Socket.IO
• Frontend: React + Vite + TanStack Router + React Query

Features

• Auth: Register, login, logout
• OAuth: Google sign-in
• Boards: Create, list, open, rename, delete boards.
• Collaboration: Invite members by email, accept/decline invites, remove members, member status tracking (pending/accepted).
• Tasks: Full CRUD, Kanban board, drag-and-drop, reorder/move.
• Real-time: WebSocket live sync for task created/updated/moved/deleted events.
• Notifications: Fetch notifications, unread counter, mark-as-read, invite-related notifications.
• UI Improvements: Better UI for Navbar and another navbar on board page
• Profile Settings: Add profile settings so user can change name, email and profile image
• Member Display: Display members
• Task Filtering: Show only tasks for selected members that are only assign to him
• Board Customization: Add themes for boards
• Dynamic Columns: Option to add your columns in boards because now its fixed
• Appearance: Add dark theme
• Auth Security: Add verification on auth
• Advanced Task Options: Add more options on task (assign, labels, deadline, creator of task, description with rich text)

Prerequisites

Install these before starting:

1. Node.js 20+
2. pnpm (npm i -g pnpm)
3. Docker Desktop (for PostgreSQL and Redis)

1. Clone Repository

git clone https://github.com/aditokmo/task-management.git
cd task-management

2. Start Infrastructure (Postgres + Redis)

From the backend folder:

cd backend
docker compose up -d

This starts:

• PostgreSQL on localhost:55432
• Redis on localhost:6379

3. Configure Backend Environment

In backend, create .env from .env.example:

cp .env.example .env

If cp is not available on Windows PowerShell, copy manually.

Default example values are already set for local Docker setup:

PORT=8000
NODE_ENV=development
DATABASE_URL=postgresql://postgres:postgres@localhost:55432/task_management
REDIS_URL=redis://localhost:6379
JWT_ACCESS_SECRET=change_me_access_secret
JWT_ACCESS_EXPIRES_IN=15m
JWT_REFRESH_SECRET=change_me_refresh_secret
JWT_REFRESH_EXPIRES_IN=7d
CORS_ORIGIN=http://localhost:5173

Update JWT secrets to secure values for real environments.

4. Install Backend Dependencies and Prepare Database

From backend:

pnpm install
pnpm prisma:generate
pnpm prisma:migrate

5. Run Backend

From backend:

pnpm start:dev

Backend runs on http://localhost:8000.

6. Install and Run Frontend

Open a second terminal:

cd frontend
pnpm install
pnpm dev

Frontend runs on http://localhost:5173.

Optional Frontend Environment

Frontend has working defaults, but you can create frontend/.env for explicit config:

VITE_API_URL=http://localhost:8000/api/v1
VITE_SOCKET_URL=http://localhost:8000

7. Open the App

Open http://localhost:5173 and use register/login to start managing tasks.

Daily Development Startup

After initial setup, use this flow:

1. Start infrastructure:

cd backend
docker compose up -d

2. Start backend:

pnpm start:dev

3. Start frontend in another terminal:

cd frontend
pnpm dev