Work Balance

Time Tracking and Client Reporting


Hours in, client reports out — one backend, desktop, web and mobile.

Work Balance

The system of record for billable work.

Work Balance tracks hours against projects and phases, and turns them into the report a client actually receives. It runs on Java 21 and Spring Boot with Microsoft Entra ID for identity, and ships as a web app, an Expo mobile app and a Tauri and Rust desktop agent.

What it changes for the business

Design discipline

Platform

Work Balance runs on AWS EC2 Graviton (arm64) with Linux, behind NGINX with TLS. Progress reports are generated as PDF, stored in AWS S3 and sent through Microsoft Graph, and the servers shut down at night to save cost.

AWS Linux

Language & Technology

The API is Java 21 with Spring Boot 4. The web app is Next.js 16 and React 19, the mobile app is Expo, and the desktop agent is built with Tauri and Rust: a native binary measured in megabytes rather than an embedded browser.

Next.js / Expo

Database

PostgreSQL on Amazon RDS for projects, phases, time entries, contracts and reports.


AI Integration

Work Balance uses AI Offices as its AI service: agents extract work items from email and handle WhatsApp conversations, so time and progress reach the system without manual data entry.

AI Offices

CI/CD & Infrastructure

Deployed with GitHub Actions assuming an AWS role through OIDC, with no static keys: the artifact goes to AWS S3, and an SSM command installs it, restarts the service and runs a health check, keeping the previous version for rollback. Secrets live in Secrets Manager, and infrastructure is code with Terraform and Ansible. Tests run with JUnit, Testcontainers (a real PostgreSQL with the Flyway migrations), Playwright and Vitest.


Integrations

People sign in with Microsoft Entra ID (multi-tenant), so client organisations use the accounts they already have in Microsoft 365; the desktop agent signs in with the device code flow. Engineers and clients use it directly, and work also arrives by email and WhatsApp through AI Offices.

Microsoft 365

Key Features

Time tracking: hours against projects and phases, from desktop, web or mobile.
Client view: hours, contracts and progress reports clients read online.
AI turns emails into time entries: through AI Offices.
Privacy by design: the desktop agent records activity metadata only, never keystrokes or screens.
Single sign-on: Microsoft Entra ID for every organisation.

Inside Work Balance


1 / 1
Work Balance on AWS

Work Balance on AWS — how a request flows, where the data lives and how it is deployed.

Account identifiers, hostnames and client data are not shown.