convez.ai
SkillDesenvolvimento WebAvançado
cuongnc0211

Hotwire Native — Skill para Claude Code

cuongnc0211/hotwire-native-skill

Hotwire Native + Rails para iOS/Android com gotchas verificados

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

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 via HotwireFragment
  • 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


License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados