Skip to main content
skill CX Codex

local-build — Claude Code skill: build APK and .app locally

local-build generates two shell scripts that produce release-ready Android APK and iOS simulator .app files for Expo projects using gradlew and xcodebuild, without cloud EAS.

no license 246 installs ★ 150 updated 2026-07-12

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Code-with-Beto/skills --skill local-build -a claude-code
Open on GitHub

What local-build does

This skill creates scripts/build-android.sh and scripts/build-ios.sh, which assemble release artifacts by reading your app's name, scheme, and bundle ID from app.json or app.config.ts and wiring them into ./gradlew assembleRelease and xcodebuild commands. Output lands in builds/ each time.

Release builds matter: Expo debug builds include expo-dev-client, which is the launcher screen showing available Development Servers, not your app itself. For e2e runs or real device testing, you need Release. The iOS script targets simulator only; physical devices need provisioning profiles and signing identity. Android APKs are signed with the debug keystore and safe for local testing, but unsuitable for Play Store—use eas build or set up a release keystore for production.

The skill checks that your directory is an Expo project (looks for expo in package.json dependencies and an app.json or config file), and that ios/ and android/ directories exist. If they don't, it suggests running npx expo prebuild. It does not hardcode app names; both scripts are bound to your actual project identity.

What it helps with

  • build a release APK locally without EAS or Play Console
  • create an iOS simulator .app outside the cloud
  • share a production-like build artifact with a teammate instantly
  • run e2e tests against the actual app, not debug launcher
  • iterate faster on a physical device without dev servers

Example prompts for the agent

  • Generate local build scripts for my Expo Android and iOS apps
  • Create build-android.sh and build-ios.sh wired to my project config
  • Set up shell scripts that produce APK and .app using gradlew and xcodebuild

How to install local-build

1Skills CLI (Vercel)

npx skills add Code-with-Beto/skills --skill local-build -a claude-code

2Manually: put the files in place

~/.claude/skills/local-build/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/local-build/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about local-build

How do I install local-build in Claude Code?

Run npx skills add Code-with-Beto/skills --skill local-build -a claude-code in your terminal, then open ~/.claude/skills/local-build/SKILL.md. The skill is ready to use.

What does local-build do?

It generates two shell scripts: one runs ./gradlew assembleRelease to produce an Android APK, the other runs xcodebuild for a simulator-compatible iOS .app. Both extract your app identity from the config and save artifacts to builds/.

Why does it build Release and not Debug?

Debug builds on Expo include expo-dev-client, which is a launcher menu for Development Servers, not your app UI. For e2e testing, device previews, or sharing with teammates, Release is what you want.

Similar skills

All skills for Mobile →

From the same set4

Project sponsors

Companies that keep this analytics open