Skip to content

timecamp-org/timecamp-planner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TimeCamp Planner

Screenshot

All-in-one project management and team chat for product teams that want speed without the bloat.
Plan work, track progress, and keep conversations close to the tasks.

Why TimeCamp Planner πŸš€

  • Projects, tasks, and realtime chat in one workspace 🧩
  • Backend API + modern web frontend out of the box 🧱
  • Docker-first setup to run locally in minutes 🐳
  • Open architecture for customization and integrations πŸ”Œ

What you get ✨

  • Task planning with lists and workflows βœ…
  • Team chat tied to work context πŸ’¬
  • Realtime collaboration ⚑️
  • API-first backend for integrations πŸ”—
  • Self-hosted, full-stack codebase 🏠

Project structure 🧭

  • backend/ - Node.js/TypeScript backend API server
  • frontend/ - React/TypeScript frontend application

Quick Start with Docker 🐳

The easiest way to run the entire project is using Docker Compose.

Prerequisites βœ…

  • Docker Desktop (or Docker Engine + Docker Compose)
  • At least 4GB of available RAM
  • Ports 3002, 3003, 5432, 6379, 5672, 15672 available

Running the Project ▢️

  1. Start all services (can take 5+ min to compile):

    cp .env.sample .env
    docker-compose up
  2. Start in detached mode (background):

    docker-compose up -d
  3. View logs:

    docker-compose logs -f
  4. Stop all services:

    docker-compose down

Accessing the Application 🌐

Once all services are running:

Note: Ports 3000 and 5432 are mapped to 3002 and 5433 respectively to avoid conflicts with local services.

Services 🧰

The Docker Compose setup includes:

  • PostgreSQL (port 5432) - Database
  • Redis (port 6379) - Caching
  • RabbitMQ (ports 5672, 15672) - Message queue
  • Backend (port 3001) - API server
  • Frontend (port 3000) - Web application
  • Ntfy (port 8080) - Push notifications

Database Setup πŸ—„οΈ

Migrations run automatically on first startup. If you need to reset the database:

docker-compose down -v
docker-compose up --build

Screenshots

Screenshot Screenshot

Roadmap πŸ›£οΈ

  • One-command local setup
  • Simplified hosting with custom domains
  • Repository cleanup and docs polish

About

πŸ”₯πŸ”₯πŸ”₯ All-in-one project management and team chat for product teams that want speed without the bloat. Plan work, track progress, and keep conversations close to the tasks.

Topics

Resources

License

Stars

3 stars

Watchers

1 watching

Forks

Contributors