Timely

Local-first desktop time tracker that syncs with GitLab. Built with Tauri v2 (Rust) + React 19 (TypeScript). All data is stored locally in SQLite — the app is read-only and never writes time entries back to GitLab.

Features

• Dashboard — Today / Week / Month views with logged hours, targets, and audit trail
• Worklog — Day, week, and month breakdowns with per-issue time entries
• GitLab sync — OAuth PKCE and PAT authentication; pulls projects, issues, and time entries
• Auto-sync — Configurable background polling (15 min – 4 h) with manual override
• System tray — Compact tray panel with progress ring and remaining hours display
• Schedule — Configurable shift hours, lunch break, workdays, and timezone
• Holidays — Country + region holiday calendar integrated into targets
• Appearance — System / light / dark theme; hours-and-minutes or decimal time format

Stack

Layer	Tech
Frontend	React 19, TanStack Router, Zustand, Tailwind CSS v4, Motion, Radix UI, Sonner
Backend	Tauri v2, Rust, rusqlite (SQLite), reqwest, tokio
Tooling	Vite 8, React Compiler, Vitest, oxlint, oxfmt, cargo clippy

Getting started

Prerequisites

• Rust (stable)
• Node.js 22.12+ or any 24.x release (24.14+ recommended)
• Tauri v2 system dependencies for your OS — see the Tauri prerequisites guide

Development

npm install
npm run tauri:dev        # Full app (Rust + Vite hot-reload on :1420)
npm run dev              # Frontend shell only; Tauri-backed data requires desktop runtime

Tests & lint

npm run test             # Vitest
npm run test:rs          # cargo test
npm run lint             # oxlint (TypeScript)
npm run lint:rs          # cargo clippy (Rust)
npm run doctor           # React Doctor
npm run fmt              # oxfmt + cargo fmt

Build

npm run tauri:build      # Production binary + installer

Project structure

src/
  app/            TanStack Router, AppShell, route components
  features/       Vertical slices: home, worklog, settings, setup, tray, …
  components/ui/  Design system primitives (shadcn-style, CVA variants)
  stores/         Single Zustand store (discriminated union lifecycle)
  lib/tauri.ts    IPC bridge — all invoke() calls with runtime guards and explicit errors
  types/          Shared TypeScript interfaces (dashboard.ts)
  styles/         OKLCH design tokens (globals.css)

src-tauri/src/
  commands/       Thin Tauri command handlers
  services/       Business logic (sync, auth, preferences, worklog)
  db/             SQLite schema, migrations, queries
  domain/         Rust models (camelCase serde for frontend compat)
  providers/      GitLab API client

License

MIT