pauzer

Pauzer

Minimal iOS gym rest timer. Tap a preset, hear a buzzer, lift again.

Stack

Expo SDK 54, React Native, TypeScript. iOS-only v1. No backend, no analytics, no auth.

Run locally

npm install
npx expo start

Then press i to open the iOS simulator, or scan the QR with Expo Go on a device.

Build for TestFlight / App Store

1. Install EAS CLI: npm install -g eas-cli
2. Log in: eas login
3. Configure (first time): eas build:configure
4. Build: eas build -p ios --profile production
5. Submit: eas submit -p ios --latest

Project structure

• App.tsx — entry; renders TimerScreen.
• screens/TimerScreen.tsx — the only screen.
• hooks/ — useTimer, usePresets, useNotifications.
• components/ — PresetButton, CountdownDisplay, CircularProgress, AddPresetModal, RunningControls.
• constants/ — colors, presets.
• utils/time.ts — MM:SS formatting.
• assets/ — icon, splash, adaptive icon, favicon. Regenerate via node scripts/generate-assets.mjs.

Privacy

Data Not Collected. No analytics, no crash reporting, no remote calls. AsyncStorage is the only persistence; it stays on the device.

App Privacy questionnaire answers (App Store Connect): Data Not Collected.

Required-reason APIs (PrivacyInfo.xcprivacy, auto-generated by Expo):

• CA92.1 — UserDefaults, because AsyncStorage uses it on iOS.

No additional entries needed. Verify the generated manifest in the .ipa via unzip -p Pauzer.ipa Payload/Pauzer.app/PrivacyInfo.xcprivacy.

Submission checklist

Things the developer must still do manually:

• Create Apple Developer account entry and App ID com.tomasmach.pauzer in App Store Connect.
• Run eas login with Apple Developer credentials.
• Run eas build -p ios --profile production to produce an IPA.
• Capture three screenshots on a real device (or simulator at correct dimensions): idle with presets, mid-countdown, completion banner.
• Fill App Store Connect metadata: name “Pauzer”, subtitle, description, keywords, primary category Health & Fitness, secondary Utilities, age rating 4+.
• Answer App Privacy questionnaire: Data Not Collected.
• Submit TestFlight build and verify on a real device: notification fires with sound and haptic when phone is locked.
• Submit to App Store review.

Scope guard

If tempted to add a feature, don’t. This app is intentionally boring. Widgets, Live Activities, Watch companion are explicitly v2.

E2E tests (Maestro)

One-time setup (developer machine):

1. Install Maestro CLI: curl -fsSL "https://get.maestro.mobile.dev" | bash
2. Build a native iOS dev client: npm run ios:dev (runs npx expo run:ios). This compiles a .app with bundle id com.tomasmach.pauzer and installs it in the simulator.

Run tests (after the app is installed in the booted simulator):

npm run test:e2e

Flows live under .maestro/:

• start-and-cancel.yaml — tap 60s preset, verify countdown shows, cancel.
• add-custom-preset.yaml — add a 2:30 preset via the modal, verify tile appears.
• delete-custom-preset.yaml — add then long-press-delete a custom preset.

Known caveats:

• Haptics and notifications aren’t asserted by flows (Maestro can’t observe them). Manual verification on a real device is still required for the completion UX.
• Flows use clearState to start from a clean AsyncStorage each run.