zeus-run-and-operate

Run, connect, and release the Zeus React Native Lightning wallet app.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-run-and-operate-aswin-dev-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zeus-run-and-operate
Source: https://github.com/aswin-dev-debug/Ai-Finance-analyzer/tree/main/lib/zeus-contrib/zeus/.claude/skills/zeus-run-and-operate
Command: npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-run-and-operate-aswin-dev-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working on the Zeus Lightning wallet often struggle with knowing when to restart Metro versus rebuilding the native app, connecting the app to a Lightning node in development, and navigating the Android reproducible release process. This Skill provides a verified runbook covering all of these operational tasks. ## Core Features & Use Cases - Dev Run Guidance: Start Metro, Android, and iOS builds with the correct yarn commands, and use a decision table to determine whether a change requires a Metro restart or a full native rebuild. - Node Connection Setup: Configure any of the 7 supported backend implementations (LDK Node, Embedded LND, LND REST, LNC, CLNRest, NWC, LNDHub), including the critical Android emulator 10.0.2.2 host rule and Polar-based local dev networks. - Release Operations: Execute the Docker-based reproducible Android build via ./build.sh, verify release APK hashes, understand per-ABI versionCodes, PGP-signed commits, and the "Version bump:" commit convention. - Use Case: You changed a native dependency and the app does not reflect your change — consult the restart-vs-rebuild decision table to learn that native changes require a full rebuild, not a Metro restart. ## Quick Start Ask how to run the Zeus app in development and connect it to a local Polar Lightning node from the Android emulator.

Frequently Asked Questions about zeus-run-and-operate

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

FAQPage Schema
How do I run the Zeus app in development mode?

Run yarn start to launch the Metro bundler, then yarn android or yarn ios to build, install, and launch on an emulator or simulator. The android and ios commands auto-start Metro if it is not already running.

When do I restart Metro versus rebuild the native app?

Restart Metro with yarn start --reset-cache after changing metro.config.js or babel.config.js. Rebuild the native app when you modify native dependencies, anything in android/, ios/, patches/, or zeus_modules native code, since Metro cannot deliver changes outside the JS bundle.

Why can't the Android emulator connect to my local Lightning node?

The Android emulator's 127.0.0.1 refers to the emulator itself, not your machine. Set the node Host field to 10.0.2.2, the emulator's alias for the host machine. The iOS simulator shares the host network, so 127.0.0.1 works there.

How do I verify a Zeus release APK with a reproducible build?

Clone the repo at the release tag and run ./build.sh, which builds inside a digest-pinned Docker image. Compare the printed sha256 of zeus-universal.apk against the hash on the GitHub releases page; signed APKs should differ only in signing certificates.

Does Zeus support reproducible builds for iOS?

No, reproducible builds are Android only, as stated in docs/ReproducibleBuilds.md. iOS is built through Xcode by opening ios/zeus.xcworkspace after running pod install, with no deterministic build pipeline in the repository.

What Lightning node backends can Zeus connect to?

Zeus supports 7 implementations: LDK Node and Embedded LND on-device, plus remote LND REST, Lightning Node Connect, Core Lightning CLNRest, Nostr Wallet Connect, and LNDHub. Each requires different credentials such as hex macaroons, runes, pairing phrases, or NWC URLs.