TaskFlow

Full-stack task management application with JWT authentication, role-based access, and a React dashboard.

Tech stack

Backend — NestJS, TypeORM, PostgreSQL, JWT, Passport, Swagger, Class Validator

Frontend — React, TypeScript, Vite, TanStack Query, Tailwind CSS, Axios, React Router

DevOps — Docker

Repository structure

Folder	Description
taskflow-backend/	NestJS REST API, PostgreSQL, Swagger
taskflow-frontend/	React + TypeScript + Vite UI

• Backend README — API docs, env setup, Docker
• Frontend README — env setup, Docker

Prerequisites

• Node.js
• PostgreSQL (for local backend development)
• npm

Quick start (local)

1. Backend

See backend README for full setup and API documentation.

cd taskflow-backend
cp .env.example .env
# Edit .env with your PostgreSQL credentials and JWT secret
npm install
npm run start:dev

API: http://localhost:3000
Swagger: http://localhost:3000/api

2. Frontend

See frontend README for full setup details.

In a second terminal:

cd taskflow-frontend
cp .env.example .env
npm install
npm run dev

App: http://localhost:5173

Ensure VITE_API_BASE_URL in the frontend .env points to the backend (default: http://localhost:3000).

Docker

Each service has its own Dockerfile. See:

• Backend Docker
• Frontend Docker

Features

• User registration and login (JWT)
• Create, update, delete, and search tasks
• Filter and sort tasks
• Admin vs user roles (backend)
• Dashboard with task statistics (frontend)