skills.rest
aswin-dev-debug
aswin-dev-debugCOMMUNITY
Explore all skills by this author →
𝕏@Aswin_Ashu9301GitHub

zeus-build-and-env

Diagnose and rebuild the Zeus React Native development environment and postinstall toolchain.

Updated Sep 2, 2026
Search Tags:#native modules#react native#gradle#cocoapods#postinstall#toolchain debugging#build environment
One-click install
npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-build-and-env-aswin-dev-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zeus-build-and-env
Source: https://github.com/aswin-dev-debug/Ai-Finance-analyzer/tree/main/lib/zeus-contrib/zeus/.claude/skills/zeus-build-and-env
Command: npx skills add https://github.com/aswin-dev-debug/Ai-Finance-analyzer --skill zeus-build-and-env-aswin-dev-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the Zeus React Native Bitcoin/Lightning wallet from scratch involves a fragile multi-step postinstall chain (patches, rn-nodeify shims, native binary downloads, CocoaPods) where any skipped step causes cryptic build or boot failures. This Skill provides the verified runbook for recreating the environment and fixing toolchain errors. ## Core Features & Use Cases - Postinstall Chain Anatomy: Documents the four ordered steps (node_modules patching, rn-nodeify shims, fetch-libraries.sh binary downloads with SHA256 enforcement, pod-install) and what breaks when each is skipped. - Native Binary Management: Covers versioned downloads of Lndmobile.aar/xcframework, LDK Node, CDK, and zeus-cashu-restore artifacts pinned in fetch-libraries-versions.json, plus uniffi binding version-match rules. - Platform Wiring Reference: Explains Android manual package registration in MainApplication.kt, iOS xcframework search paths, vendored zeus_modules rules, and from-scratch bring-up checklists for both platforms. - Use Case: When yarn install fails with a checksum error or Xcode reports "framework 'Lndmobile' not found", use this Skill to identify which postinstall step failed and how to re-run it safely. ## Quick Start Ask the AI to walk you through setting up the Zeus dev environment from a fresh clone or to diagnose why yarn install is failing on the postinstall step.

Frequently Asked Questions about zeus-build-and-env

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

FAQPage Schema
How do I set up the Zeus React Native dev environment from scratch?▼

Install Node 22.11+ (24.x recommended) and Yarn classic, clone the repo, then run yarn to trigger the full postinstall chain: patches, rn-nodeify shims, fetch-libraries binary downloads, and pod-install. Then run yarn start and yarn android or yarn ios.

Why does yarn install fail with a checksum failed error?▼

A checksum failure means a downloaded native binary or uniffi binding does not match the SHA256 hash pinned in fetch-libraries-versions.json. Delete the cached artifact and re-run yarn fetch-libraries; never blank the hash field, since empty hashes fail closed.

How do I fix 'framework Lndmobile not found' in Xcode?▼

This error means fetch-libraries.sh did not download Lndmobile.xcframework into ios/LncMobile/. Re-run yarn fetch-libraries, then run pod install so the Podfile post_install hook adds the framework search paths.

Why is NativeModules.MyModule null at runtime on Android?▼

App-local native modules are not autolinked in Zeus; they must be manually registered in android/app/src/main/java/com/zeus/MainApplication.kt via add() calls. Add your package there alongside the existing ten registered packages.

Can I hand-edit shim.js or the package.json alias maps?▼

No. rn-nodeify regenerates shim.js and the react-native/browser alias maps in package.json on every yarn install, so manual edits are clobbered. Make changes through the rn-nodeify configuration instead.

When should I not use this build environment runbook?▼

Do not use it for day-to-day app runs, release builds, jest/CI test anatomy, runtime debugging after the app boots, or adding new dependencies. Those belong to the sibling run-operate, validation, debugging, and change-control skills.

Related Skills

Explore More Software Engineering Skills→
TMHSDigitalTMHSDigital
2

mobile-dev-environment

Detect missing mobile development tools and SDKs across macOS, Windows, and Linux.

Community
Intermediate
BuilderIOBuilderIO
11

android-native

Build and deploy Android APKs to emulators and devices using Gradle and adb.

Official
Intermediate
renuorenuo
3

deploio-debug

Diagnose and fix Deploio app crashes, build failures, and runtime errors.

Official
Advanced
NevaberryNevaberry
22

docker-knowledge-patch

Enforce current Docker Buildx and Bake behaviors with Rego policy evaluation.

Official
Intermediate