Skip to content
Back to search

codex-phone-lab

Codex skill for building Expo apps live on a real phone

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kappaemme-git--codex-phone-lab/badge.svg)](/listings/kappaemme-git--codex-phone-lab)

HTML

<a href="/listings/kappaemme-git--codex-phone-lab"><img src="/api/listings/kappaemme-git--codex-phone-lab/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 102 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Codex Phone Lab
  2. Prompt to phone app.
  3. `codex-phone-lab` installs a Codex skill that helps Codex create Expo/React Native apps and open them on a real iPhone or Android device through Expo Go.
  4. No Xcode setup. No TestFlight. No App Store wait.
  5. ```bash
  6. npx --yes codex-phone-lab
  7. ```
  8. Then use it in Codex:
  9. ```text
  10. Use $codex-phone-lab and make me a notes app for my phone.
  11. ```
  12. ## What It Does
  13. - Checks the local Node/npm/Expo environment.
  14. - Creates Expo SDK 54 apps by default so they work with the current Expo Go workflow.
  15. - Starts the Expo phone preview server.
  16. - Shows the QR flow for Expo Go.
  17. - Guides Codex to build real mobile screens instead of generic landing pages.
  18. - Keeps the live loop: prompt, code, phone refresh.
  19. ## Why
  20. Codex can write mobile code, but the phone loop is usually the slow part.
  21. This skill packages the workflow:
  22. ```text
  23. prompt -> Expo app -> QR code -> real phone -> live edits
  24. ```
  25. It is meant for quick MVPs, app ideas, prototypes, demos, and internal tools.
  26. ## Requirements
  27. - Node.js and npm.
  28. - Expo Go installed on your iPhone or Android phone.
  29. - Phone and computer on the same Wi-Fi for LAN mode.
  30. If LAN mode fails, use tunnel mode:
  31. ```bash
  32. ~/.codex/skills/codex-phone-lab/scripts/start-phone-preview.sh tunnel
  33. ```
  34. ## Commands
  35. After installation, the skill lives at:
  36. ```text
  37. ~/.codex/skills/codex-phone-lab
  38. ```
  39. Create a new Expo app:
  40. ```bash
  41. ~/.codex/skills/codex-phone-lab/scripts/new-expo-app.sh my-phone-app
  42. ```
  43. Start the phone preview:
  44. ```bash
  45. cd my-phone-app
  46. ~/.codex/skills/codex-phone-lab/scripts/start-phone-preview.sh lan
  47. ```
  48. Run a quick environment check:
  49. ```bash
  50. ~/.codex/skills/codex-phone-lab/scripts/doctor.sh
  51. ```
  52. ## Expo SDK Version
  53. The skill defaults to:
  54. ```text
  55. expo-template-default@sdk-54
  56. ```
  57. This avoids the common Expo Go error:
  58. ```text
  59. Project is incompatible with this version of Expo Go
  60. ```
  61. Override the template only when your Expo Go supports a newer SDK:
  62. ```bash
  63. CODEX_PHONE_LAB_EXPO_TEMPLATE=expo-template-default@sdk-55 \
  64. ~/.codex/skills/codex-phone-lab/scripts/new-expo-app.sh my-app
  65. ```
  66. ## License
  67. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.