
🌐 Website • Features • Installation • Usage • Development • Roadmap
Light Theme | Dark Theme | Mobile View |
---|---|---|
Feature | Description |
---|---|
🏠 Complete Privacy | Self-hosted on your infrastructure with zero tracking or data collection |
📝 Smart Task Creation | Natural language parsing ("tomorrow at 2pm") with unlimited subtasks and rich details |
🔄 Recurring Tasks | Daily, weekly, monthly, or custom patterns with automatic scheduling |
📊 Project Organization | Group tasks by projects with sections, color-coded labels, and multiple views |
🎨 Modern Interface | Clean design with dark/light themes, mobile-friendly, and keyboard shortcuts |
💾 Simple Data Management | File-based storage in JSON format for easy backups and transfers |
# Quick start
docker run -p 3000:3000 -v ./data:/app/data -d --name tasktrove ghcr.io/dohsimpson/tasktrove
# Download setup files
git clone https://github.com/dohsimpson/TaskTrove
cd TaskTrove/selfhost
# Start TaskTrove
docker-compose up -d
# Clone repository
git clone https://github.com/dohsimpson/TaskTrove
cd TaskTrove
# Install dependencies
pnpm install
# Build and start
pnpm build
pnpm start
Key | Action |
---|---|
n |
Quick add new task |
/ |
Search tasks and projects |
Space |
Mark task as complete/incomplete |
Esc |
Close details panel or dialogs |
- 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
cp data/data.json ~/tasktrove-backup-$(date +%Y%m%d).json
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 checkingpnpm lint
- Code lintingpnpm test
- Run testspnpm run check
- Full validation
We welcome and appreciate all contributions! Thank you for helping make TaskTrove better.
Process:
- Open an issue first - Discuss bugs in GitHub Issues, or features in GitHub Discussions
- Submit your PR - You'll be prompted to sign our CLA (Contributor License Agreement)
- Code review - A maintainer will review your changes and provide feedback
- 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)
See LICENSE.md for license terms and pricing.
Happy Tasking!