Tempo Tracker is a task management application built with electron-vite, designed with a primary focus on the time tracking aspect of productivity. It allows users to organize work into different task collections while providing detailed reporting on time allocation.
Data is stored locally using SQLite3, ensuring privacy and performance. For portability, the application supports moving data between different machines through JSON export and import functionality available in the settings.
To set up Tempo Tracker locally for development or to build from source:
-
Clone the repository:
git clone https://github.com/cstdnl/tempo-tracker.git cd tempo-tracker -
Install dependencies:
npm install
-
Run in development mode:
npm run dev
-
Build for production:
# Build for macOS (Universal/ARM/Intel) npm run build:mac # Build for Windows npm run build:win
The current stable release is optimized for Apple Silicon (M1/M2/M3/M4).
- Target Architecture: arm64
- Format: .dmg and .zip
- Task Organization: Create and manage tasks across different collections for better categorization.
- Time-Centric Design: Every task is built around its time tracking state, allowing for precise monitoring of effort.
- Subtask Tracking: Break down tasks within collections into granular, trackable items.
A specialized feature for deep work on a single task:
- Compact UI: Switches to a small, always-on-top window (320x240px).
- Essential Controls: Provides a simplified timer and basic controls to minimize distractions.
- Draggable Handle: The window can be moved freely across the screen.
- Time Reporting: Generate and view csv reports based on your tracked time data to analyze productivity trends.
- Local Storage: Uses SQLite3 for fast, secure, and local data persistence.
- Export/Import: Move your entire database between machines using JSON export and import tools in the settings menu.
- Framework: Electron with electron-vite
- Frontend: React with TypeScript
- Styling: Tailwind CSS & Shadcn UI
- Database: SQLite3 for local persistence.
- Initiation: Select the Focus icon on a specific task.
- Window Management: The application resizes to a minimal footprint and stays on top of other windows.
- Tracking: The FocusPage provides a streamlined interface focused entirely on the active timer.
The application manages all task and time data through a local SQLite3 instance. Users can migrate their data by generating a JSON export in the settings, which can then be imported on another device to restore the complete state of tasks and collections.
Distributed under the MIT License. See LICENSE for more information.