TaskTrove

🌐 Website • Features • Installation • Usage • Development • Roadmap

Light Theme	Dark Theme	Mobile View

✨ Features

📦 Installation

Docker (Recommended)

# Quick start
docker run -p 3000:3000 -v ./data:/app/data -d --name tasktrove ghcr.io/dohsimpson/tasktrove

Docker Compose

# Download setup files
git clone https://github.com/dohsimpson/TaskTrove
cd TaskTrove/selfhost

# Start TaskTrove
docker-compose up -d

Manual Setup

# Clone repository
git clone https://github.com/dohsimpson/TaskTrove
cd TaskTrove

# Install dependencies
pnpm install

# Build and start
pnpm build
pnpm start

💻 Usage

Keyboard Shortcuts

Task Features

• Natural Language: "tomorrow at 2pm", "next Friday", "every Monday"
• Subtasks: Break down complex projects into manageable pieces
• Rich Details: Priorities, due dates, comments, file attachments
• Views: List, Kanban board, and Calendar views

Backup Your Data

cp data/data.json ~/tasktrove-backup-$(date +%Y%m%d).json

🧩 Development

Want to contribute? Check out the development setup:

git clone https://github.com/dohsimpson/TaskTrove
cd TaskTrove
pnpm install
pnpm dev

Key Commands:

• pnpm typecheck - Type checking
• pnpm lint - Code linting
• pnpm test - Run tests
• pnpm run check - Full validation

Contributing

We welcome and appreciate all contributions! Thank you for helping make TaskTrove better.

Process:

1. Open an issue first - Discuss bugs in GitHub Issues, or features in GitHub Discussions
2. Submit your PR - You'll be prompted to sign our CLA (Contributor License Agreement)
3. Code review - A maintainer will review your changes and provide feedback
4. Merge - Once approved, your contribution will be merged

Guidelines:

• Follow existing code patterns and test coverage requirements
• Add unit tests for non-trivial changes
• AI assisted PRs are allowed, but through review is required before submitting. Make sure you are the sole contributor of the PR (avoid co-authored by XYZ in commit message)

📄 License

See LICENSE.md for license terms and pricing.