Unofficial iOS Companion App (fork) — FYI for iPhone users #205

Hi! Love the project — PokeTokenBar is genuinely one of the most fun tools I use daily.

I put together an unofficial iOS companion app and wanted to leave an updated pointer here for anyone looking to monitor their token burn and companion on their phone:

👉 https://github.com/cte13/PokeTokenBar-iOS

What it is

An iPhone companion app plus WidgetKit extensions mirroring the Mac dashboard:

• Companion Status & Tabs: Animated sprite, nature, shiny indicator, and evolution path, along with read-only views for your Bag, Collection (Pokédex), and Shop.
• Usage & Limit Tracking: Today's tokens and cost, weekly/monthly totals, per-provider breakdowns, and rate-limit countdowns + utilization history across supported providers.
• Home & Lock Screen Widgets: Medium Home Screen widget with live limit bars and mini pie indicators, plus Lock Screen accessory widgets (circular, rectangular, inline).
• Fast Cold Start & Offline Support: Instant launch from local cache with background sync.
• Appearance Switcher: Light, dark, and system appearance modes with tailored companion styling.

How data reaches your phone

• iCloud CloudKit (Primary): The Mac app automatically writes a single JSON snapshot to the user's private CloudKit database on refresh. The phone app and widgets read from iCloud seamlessly with zero configuration and across different networks (no shared Wi-Fi required).
• Local Network Fallback: The Mac can also serve a lightweight local HTTP endpoint with pairing-code security published via Bonjour for same-network setups.

The iOS companion is purely a read-only viewer and does not modify the macOS app's gameplay state or internals.

Credit & Transparency

• Credit: All the original game mechanics, balance curves, rarity tables, hatch thresholds, and log parsing architecture come directly from your Swift source. My README explicitly points users to star and support your repository.
• Being upfront: This companion was developed iteratively with AI coding assistants using your Swift codebase as the specification. The shared data models (PokeTokenBarShared) are structured as a clean cross-platform SPM package (macOS, iOS, visionOS), and the fork is actively maintained and kept in sync with your upstream main branch.