Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Ajith66310/task-manager-full/llms.txt

Use this file to discover all available pages before exploring further.

TaskFlow ships as a fully containerized application. Docker Compose is the only supported way to build and run the complete stack. A single command compiles every service, pulls base images, wires the internal network, and starts all 8 containers in detached mode — no manual setup of individual services required.

Initial startup

1

Install prerequisites

Ensure Docker Desktop is installed and running on your system. Verify it is available by running:
docker --version
docker compose version
2

Configure environment variables

Populate the required .env files for each service before starting the stack. See the Environment variables reference for the full list of required values.
3

Build and start all containers

From the project root directory, run:
docker-compose up --build -d
This command builds every service image from source, pulls mongo:latest and nginx:alpine base images, and starts all 8 containers in the background. The --build flag ensures local source code changes are compiled into fresh images.
4

Verify the stack is running

Check that all containers have started successfully:
docker-compose ps
All 8 services should show a running or Up state before you access the application.
5

Access the application

Once all containers are healthy, the following URLs are available:
InterfaceURL
User frontendhttp://localhost:5173
Admin dashboardhttp://localhost:3000
API Gatewayhttp://localhost:5000

Common operations

Check container status

docker-compose ps

View logs

Stream logs from all running services:
docker-compose logs -f
Tail logs for a specific service only:
docker-compose logs -f user-service

Rebuild a single service

When you modify source code in one service, rebuild only that container without restarting the entire stack:
docker-compose stop <service>
docker-compose rm -f <service>
docker-compose up -d --build <service>
For example, to rebuild task-service after a code change:
docker-compose stop task-service; docker-compose rm -f task-service; docker-compose up -d --build task-service

Stop all services

Suspend all containers and remove the Compose network, preserving database volumes:
docker-compose down

Teardown with volume removal

Running docker-compose down -v permanently deletes the mongo_user_data and mongo_task_data volumes. All task and user records stored in the database will be lost and cannot be recovered.
To fully tear down the stack and wipe all persistent data:
docker-compose down -v

Build docs developers (and LLMs) love