Skip to content

IgorGanapolsky/Random-Timer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,031 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Random Tactical Timer

License: MIT CI Claude Review GitHub Copilot Review Sentry Seer Cursor BugBot SonarQube Cloud iOS Android

Train reaction, not rhythm. Random interval timer for MMA, BJJ, boxing, muay thai, kickboxing, HIIT, CrossFit, sparring, tabata, pad work, and tactical drills. Native iOS + Android app: the buzzer fires at a random moment inside your range so you cannot anticipate it.

Store-facing line: TRAIN FOR CHAOS. NOT RHYTHM. — same headline as App Store description and Play Store full description (en-US).

Store One-liner (en-US)
App Store subtitle Random HIIT & combat training
Play short description Random tactical timer: MMA, BJJ, boxing, muay thai & HIIT. AI coach voices.

Screenshots = store assets

Images below are not a second set of mocks — they are the same files shipped in Fastlane metadata (en-US).

iPhone (native-ios/fastlane/screenshots/en-US/)

Setup: timer range and start Active random interval Alarm / cue Running state

Android phone (native-android/fastlane/metadata/android/en-US/images/phoneScreenshots/)

Setup Active timer Voice callouts (Pro) Loop mode

iPad / additional iOS sizes: same folder (5_ipad_*7_ipad_*).


Diagrams

Training loop

flowchart LR
  A[Set min/max range] --> B[Start]
  B --> C[Drill / train]
  C --> D[Random cue]
  D --> E{Loop?}
  E -->|Yes| C
  E -->|No| F[Stop / dismiss]
Loading

Repository layout

flowchart TB
  subgraph apps [Native apps]
    iOS[iOS — SwiftUI / Live Activities / StoreKit]
    AND[Android — Compose / FGS / Play Billing]
  end
  subgraph meta [Store & screenshots]
    FM[iOS Fastlane metadata + screenshots]
    AM[Android Fastlane metadata + images]
  end
  subgraph auto [Automation]
    PY[scripts/ — Python tooling]
    GA[.github/workflows — CI & release]
  end
  iOS --> FM
  AND --> AM
  apps --> GA
  PY --> GA
Loading

Tech summary

Layer Stack
iOS Swift 6, SwiftUI, Live Activities, AVFoundation alerts, StoreKit, PostHog
Android Kotlin, Jetpack Compose, Hilt, foreground service, Play Billing, PostHog, Firebase crash/analytics
Repo Python automation in scripts/, workflows in .github/workflows/, Fastlane under each native-* tree

Build & verify

Entry point: Makefile.

make verify

Details: iOS native-ios/ (xcodebuild), Android native-android/ (./gradlew …). See Makefile targets for simulators, Maestro, and platform-specific checks.


Docs index

Doc Purpose
docs/REPO_PROFILE.md GitHub About text, topics, links — keep in sync with this README
docs/pr-review-bots.md PR review / bot matrix
docs/north-star-baseline.md Dated WQTU snapshot (verify live metrics in PostHog)
CLAUDE.md Operator rules, budgets, release flow
AGENTS.md Agent / AI instructions
PRIVACY_POLICY.md Privacy (linked from store metadata)

Repository layout (2026)

Path Role
marketing/site/ GitHub Pages deploy root (daily-growth-publishing workflow)
marketing/product-pages/ Product landing HTML + AMP + llms.txt (kept out of repo root)
config/ Tooling config (e.g. Sonar properties)
scripts/shell/ Bash entrypoints; Python automation stays in scripts/ (see scripts/README.md)

License

MIT — Igor Ganapolsky

Sponsor this project

 

Packages

 
 
 

Contributors