Time Cracker ⏱

A desktop time tracking application for managing your 168 hours per week.

Features

• Weekly time tracking — Visualize your week across all tasks
• Task management — Create tasks with weekly targets, categories, and colors
• Pomodoro support — Set per-task pomodoro lengths
• Session history — Undo/redo last sessions without losing data
• Manual session entry — Log past sessions retroactively
• Week closure — Close the week with analytics and start fresh
• Data export/import — Backup and restore your data as JSON
• Dark/light theme — Persistent theme preference
• Drag to reorder — Arrange task bars by priority
• Pi server sync — Optional sync with a Raspberry Pi backend (advanced)

Getting Started

Prerequisites

• Node.js v18+
• npm

Install & Run

npm install
npm run dev

Build for Production

# Build React app
npm run build

# Package as Windows installer
npm run build:electron

The installer will be at build/Time Cracker Setup 1.0.0.exe.

Project Structure

├── electron/          # Electron main process
│   ├── main.js        # IPC handlers, app lifecycle
│   ├── database.js    # SQLite via sql.js
│   ├── preload.js     # Secure context bridge
│   └── syncService.js # Optional Pi sync
├── src/               # React frontend
│   ├── components/    # UI components
│   ├── hooks/         # Custom React hooks
│   ├── services/      # Mock API for browser dev
│   └── types/         # TypeScript types
└── assets/            # App icons

Data Storage

Your data is stored locally and never sent anywhere without your explicit configuration:

• Database: %APPDATA%/Time Cracker/time-cracker.db
• Settings: %APPDATA%/Time Cracker/settings.json

Privacy

• All data stays on your machine by default
• The optional Pi sync feature requires manual configuration with your own server
• No telemetry, no analytics, no external connections

License

MIT