Hotwire Native — Skill para Claude Code
cuongnc0211/hotwire-native-skill
Hotwire Native + Rails para iOS/Android com gotchas verificados
Ver no GitHubSkill especializada para desenvolvedores Rails construírem aplicativos iOS/Android com Hotwire Native. Cobre setup, configuração de paths, integração Rails, navegação, componentes nativos, bridge JS↔Swift/Kotlin, push notifications e deployment. Baseada em gotchas verificados em builds reais, não apenas espelho da documentação oficial.
Instalação
npx convez-ai cuongnc0211/hotwire-native-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Configurar projeto iOS/Android com Hotwire Native do zero
- Debugar comportamentos não-documentados em path configuration e Auth CSRF
- Integrar componentes nativos SwiftUI/Jetpack Compose em apps híbridos
- Implementar push notifications (APNs/FCM) com Rails Noticed gem
- Deployar em TestFlight e Play Store com URL switching
Veredito

Skill bem-estruturada e eminentemente prática para quem trabalha com Hotwire Native em produção. O diferencial honesto (gotchas reais vs docs) é valioso, embora exija re-verificação em cada nova versão dos SDKs.
README
A tradução para o português deste README ainda está na fila.
Hotwire Native — Claude Code Skill
A Claude Code Agent Skill for Rails developers building iOS/Android apps with Hotwire Native.
Unique value: verified real-world gotchas from actual builds — the API deltas, Swift 6 quirks, and Rails/Propshaft traps that the official docs don't cover. Not a docs mirror.
Verified against: hotwire-native-ios 1.2.2 · hotwire-native-android 1.2.8 (docs-sourced) · Rails 8.1
What it covers
- iOS and Android project setup (UIKit lifecycle, Gradle, ATS)
- Path configuration — JSON anatomy, ordering rules, server-deployed behavior changes
- Rails integration —
hotwire_native_app?, hiding web chrome, persistent auth, CSRF rules - Navigation — tab bars, modal vs push, snapshot cache
- Native screens — SwiftUI via
UIHostingController, Jetpack Compose viaHotwireFragment - Bridge components — JS ↔ Swift/Kotlin message protocol, progressive enhancement
- Push notifications — APNs/FCM, Noticed gem, token idempotency
- Deployment — TestFlight, Play Internal Testing, device URL switching
- Troubleshooting — symptom → cause table, debugging order for "native thing doesn't show"
Install
Option A — copy to ~/.claude/skills/
cp -r hotwire-native ~/.claude/skills/hotwire-native
Claude Code loads skills from ~/.claude/skills/ automatically. The skill activates when
you're working on a Hotwire Native project.
Option B — per-project symlink
mkdir -p .claude/skills
ln -s /path/to/hotwire-native .claude/skills/hotwire-native
Option C — Claude Code plugin (.claude/plugins/)
If you're distributing this inside an org via the Claude Code plugin marketplace, register
it in your marketplace.json. The skill directory is the plugin root.
How it works
Claude loads SKILL.md first on activation. SKILL.md contains the decision framework,
fast-path checklist, routing table, and top gotchas. Claude then loads individual files
from references/ on demand as the question narrows.
hotwire-native/
├── SKILL.md # entry point — decision framework, routing table, top gotchas
└── references/ # 13 task-focused files loaded on demand
├── rails-integration.md
├── path-configuration.md
├── setup-ios.md
├── setup-android.md
├── navigation-and-tabs.md
├── native-screens-ios.md
├── native-screens-android.md
├── bridge-components.md
├── bridge-components-ios.md
├── bridge-components-android.md
├── push-notifications.md
├── deployment.md
└── troubleshooting.md
Re-verification
Content marked ✅ Verified (hotwire-native-ios x.y.z, Rails x.y) was confirmed in a
real build. Unmarked content is docs-sourced. When a new SDK version ships, re-check:
# Confirm iOS SDK signatures in your Xcode DerivedData
find ~/Library/Developer/Xcode/DerivedData -path "*SourcePackages/checkouts/hotwire-native-ios*"
grep -rn "public func\|public init\|public var" <that-path>/Source
Update the verified-versions statement in SKILL.md and the ✅ markers in affected
reference files after re-verification.
Further reading
- Hotwire Native official docs
- hotwire-native-ios on GitHub
- hotwire-native-android on GitHub
- Hotwire Native for Rails Developers by Joe Masilotti (PragProg) — recommended book
License
MIT — see LICENSE.