ios-sync

Regenerate the iOS debug bridge against upstream gstack templates.

1|Updated May 27, 2026
One-click install
npx skills add https://github.com/mi179/claude-skills --skill ios-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-sync
Source: https://github.com/mi179/claude-skills/tree/main/user/gstack/ios-sync
Command: npx skills add https://github.com/mi179/claude-skills --skill ios-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Regenerate the iOS debug bridge against the latest upstream gstack templates. This keeps StateServer.swift, DebugOverlay.swift, Package.swift, and the typed @Observable state accessors aligned with the current gstack version, ensuring compatibility after upgrades or when new ViewModels or properties are added.

Core Features & Use Cases

  • Synchronizes iOS instrumentation and accessors with upstream gstack templates to reflect changes in ViewModels and state accessors.
  • Updates the debug bridge components (StateServer.swift, DebugOverlay.swift, Package.swift) to maintain compatibility with the iOS-side tooling.
  • Use during post-upgrade maintenance or when tooling requests a resync of the iOS debug bridge.

Quick Start

Run the ios-sync skill to regenerate the iOS debug bridge after upgrading gstack.

Frequently Asked Questions about ios-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync iOS debug bridge files after upgrading gstack?▼

To sync the iOS debug bridge after a gstack upgrade, regenerate StateServer.swift, DebugOverlay.swift, and Package.swift against the latest upstream templates to ensure state accessors and instrumentation stay aligned.

Why does my iOS instrumentation break when adding new ViewModels?▼

iOS instrumentation breaks when new ViewModels are added because typed @Observable state accessors become outdated. Regenerating the debug bridge resyncs these accessors with the current gstack templates to restore coverage.

Does gstack state accessor coverage require manual Swift package updates?▼

State accessor coverage requires updating Package.swift along with StateServer.swift and DebugOverlay.swift. Regenerating the debug bridge enforces these updates to maintain iOS-side tooling compatibility.

What is the best way to regenerate iOS debug overlays for gstack?▼

The best way to regenerate iOS debug overlays is running a dedicated sync process that updates DebugOverlay.swift and related components against upstream gstack templates, ensuring all state accessors reflect current ViewModel properties.

Can I update StateServer.swift manually without regenerating the full debug bridge?▼

Updating StateServer.swift manually risks desyncing iOS instrumentation from upstream gstack templates. Regenerating the full debug bridge ensures StateServer.swift, DebugOverlay.swift, and Package.swift stay synchronized with current state accessors.