# phone-builds

phone-builds is a Claude Code skill that builds Expo and React Native apps for phones or store testing. It runs when a task calls for an IPA, APK, or TestFlight upload.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 149 repo stars
- Author: 0xdaniell
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/0xdaniell/macbox/tree/HEAD/src/skills/phone-builds/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/phone-builds

## What it does

The skill runs `phone-build` to produce iOS or Android builds and send them to TestFlight or Google Play. It uses available free EAS cloud builds first, then switches to local builds: Android on the current machine and iOS on a macOS VM over SSH. Set up an app with `phone-build init` and its `eas.json` file.

iOS requires a paid Apple Developer Program membership, an Expo login, and an Expo token stored in `~/.config/macbox/expo.env`. Local iOS builds also need `eas-cli` and `fastlane` on the Mac; Android uses the SDK from `android-sim env`. Register an iPhone for internal builds. Simulator-based UI checks belong to the separate simulators skill.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill phone-builds -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/phone-builds/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/phone-builds/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill phone-builds -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/phone-builds/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill phone-builds -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/phone-builds/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 0xdaniell/macbox src/skills/phone-builds
```

2. **Manually: put the files in place**
- File: `.github/skills/phone-builds/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill phone-builds -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/0xdaniell/macbox --path src/skills/phone-builds
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/phone-builds/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/0xdaniell/macbox/tree/HEAD/src/skills/phone-builds/SKILL.md

## When to use it
- build an IPA for an iPhone
- create an Android APK or AAB
- send an iOS build to TestFlight
- upload an AAB to Google Play internal testing

## Example prompts
- Build this Expo app for installation on my iPhone.
- Create an APK from this React Native app.
- Send the iOS build to TestFlight.

## Similar
- [capgo-native-builds](https://affpapa.org/en/nevibecode/skills/capgo-native-builds.md) — skill · 774 installs
- [compare-builds](https://affpapa.org/en/nevibecode/skills/compare-builds.md) — skill · 317 installs
- [open-autoglm-phone-agent](https://affpapa.org/en/nevibecode/skills/open-autoglm-phone-agent.md) — skill · 1400 installs
- [Sms Gateway using your phone](https://affpapa.org/en/nevibecode/mcp/sms-gateway-using-your-phone.md) — MCP server · 1800 installs
- [debug-optimized-builds](https://affpapa.org/en/nevibecode/skills/debug-optimized-builds.md) — skill · 621 installs
- [godot-export-builds](https://affpapa.org/en/nevibecode/skills/godot-export-builds.md) — skill · 502 installs

From the same set: [0xdaniell/macbox](https://affpapa.org/en/nevibecode/by/0xdaniell/macbox.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
