UI Architecture (iOS + Mac Catalyst)

Overview of the app’s user interface. For component details, see linked notes.

  • Single unified ContentView (no tabs)
  • Settings via gear icon (top right) - 405-settings-sheet
  • Floating play button (bottom center)

Main Sections

SectionDescriptionDetails
Running TimersActive timers at top406-record-editor
TodayCompleted records for todaySwipe to delete with 412-deletion-toast
HistoryFiltered records with export407-history-section

State Management

Key Components

ComponentPurpose
406-record-editorEdit running timers and completed records
407-history-sectionDate/tag filtering, Grid table, export
408-date-range-pickerPreset buttons + custom range
409-tag-filterTag toggle buttons with context menu
410-flow-layoutCSS flex-wrap style layout
411-share-export-sheetExport format selection
412-deletion-toastUndo support for deletions

File Structure

Sources/
  MinutaApp.swift                # Entry point, AppState
  AppIntents.swift               # Shortcuts integration
  Services/
    StorageLocationManager.swift # Folder selection
  Views/
    ContentView.swift            # Main view (~105 lines)
    Components/                  # Reusable components
    History/                     # History-related views
    Sections/                    # Main sections
    Settings/                    # Settings views

Mac Catalyst

  • Title bar hidden via SceneDelegate
  • Native save panel for exports
  • Traffic lights visible

App Intents

IntentDescription
StartTimerIntentStart timer with optional tag name/comment; an unknown name creates the tag
StopTimerIntentStop all running timers
StartTimerFromWidgetIntentWidget button: start a timer, optional tag ID (not discoverable in Shortcuts)
StopTimerFromWidgetIntentWidget button: stop one timer by ID (not discoverable)
StopAllTimersFromWidgetIntentWidget button: stop all timers (not discoverable)

The widget intents live in Sources/WidgetIntents.swift, compiled into both the app and the widget extension; they run in the app process in the background (ForegroundContinuableIntent). All five run through WidgetIntentService, which also updates the recent tags and the widget snapshot. See WidgetData.