Files

Simon Franken 461405c418 Fix iOS timer widget not displaying active timers

The widget was failing to decode the cached timer data because WidgetTimer
struct didn't match the OngoingTimer JSON structure saved by the app.

Changes:
- Added missing fields (project, createdAt, updatedAt) to WidgetTimer
- Added WidgetProjectReference struct for nested project data
- Fixed project name to use project.name instead of projectId
- Added project color support
- Increased refresh interval from 15 min to 1 min for live updates

2026-02-20 15:49:35 +01:00

TimeTracker

Merge branch 'main' into feature/ios-delete-confirmation

2026-02-20 15:35:02 +01:00

TimeTrackerWidget

Fix iOS timer widget not displaying active timers

2026-02-20 15:49:35 +01:00

.gitignore

adds git ignore

2026-02-18 21:45:09 +01:00

project.yml

adds ios

2026-02-18 21:35:32 +01:00

README.md

adds ios

2026-02-18 21:35:32 +01:00

README.md

TimeTracker iOS App

Setup Instructions

Prerequisites

XcodeGen - Required to generate the Xcode project

# On macOS:
brew install xcodegen

# Or via npm:
npm install -g xcodegen

Xcode - For building the iOS app (macOS only)

Project Generation

After installing XcodeGen, generate the project:

cd ios/TimeTracker
xcodegen generate

This will create TimeTracker.xcodeproj in the ios/TimeTracker directory.

Configuration

Before building, configure the API base URL:

Open TimeTracker.xcodeproj in Xcode
Select the TimeTracker target
Go to Info.plist
Add or modify API_BASE_URL with your backend URL:
- For development: http://localhost:3001
- For production: Your actual API URL

Building

Open the project in Xcode and build:

open ios/TimeTracker/TimeTracker.xcodeproj

Then select your target device/simulator and press Cmd+B to build.

Authentication Setup

Configure your OIDC provider settings in the backend
The iOS app uses ASWebAuthenticationSession for OAuth
The callback URL scheme is timetracker://oauth/callback

App Groups

For the widget to work with the main app, configure the App Group:

Identifier: group.com.timetracker.app
This is already configured in the project.yml

Dependencies

The project uses Swift Package Manager for dependencies:

SQLite.swift - Local database
KeychainAccess - Secure storage

Project Structure

TimeTracker/
├── TimeTrackerApp/          # App entry point
├── Core/
│   ├── Network/             # API client
│   ├── Auth/               # Authentication
│   └── Persistence/        # SQLite + sync
├── Features/
│   ├── Auth/              # Login
│   ├── Timer/              # Timer (core feature)
│   ├── TimeEntries/       # Time entries CRUD
│   ├── Projects/          # Projects CRUD
│   ├── Clients/           # Clients CRUD
│   └── Dashboard/         # Dashboard
├── Models/                  # Data models
├── Shared/                  # Extensions & components
└── Resources/              # Assets

TimeTrackerWidget/           # iOS Widget Extension