What this skill does

# cancorteaw-app Local **Expo / React Native** app builder runner for my OpenClaw server. This skill is a **controlled runner** that only executes an allowlisted script: `/home/patron/apps/_bin/appctl` and that script is restricted to operate under: `/home/patron/apps/<project>`. ## What it does This skill wraps `appctl` to provide a safe, repeatable workflow: - **Create** a new Expo app scaffold under `/home/patron/apps/<name>` - **Add a screen** file under `/home/patron/apps/<name>/app/<Screen>.tsx` - **Start a web preview** (`expo start --web`) bound to `127.0.0.1` on a chosen port - **Check status** of the preview process ## Commands ### 1) Create a new app **Command:** - `new <name>` **Example:** - `new demoapp` **Result:** - Creates `/home/patron/apps/demoapp` - Initializes git (best-effort) - Uses `npx create-expo-app` in non-interactive mode --- ### 2) Add a screen **Command:** - `add-screen <name> <screenName> <title>` **Example:** - `add-screen demoapp Settings "Settings"` **Result:** - Writes: `/home/patron/apps/demoapp/app/Settings.tsx` - Makes a git commit (best-effort) --- ### 3) Start web preview **Command:** - `preview <name>` **Environment:** - `EXPO_PORT` (optional): override preview port Default: `19006` **Example:** - `preview demoapp` - `EXPO_PORT=19010 preview demoapp` **Result:** - Starts `npx expo start --web --port <port>` - Writes logs to: `/home/patron/apps/_logs/<name>.preview.log` - Writes pid to: `/home/patron/apps/_state/<name>.pid` - Writes port to: `/home/patron/apps/_state/<name>.port` --- ### 4) Status **Command:** - `status <name>` **Example:** - `status demoapp` **Result:** - Prints RUNNING with URL if process is alive - Otherwise prints STOPPED ## Safety / Guardrails - The runner is **allowlisted**: only `node`, `npm`, `npx`, `git`, `bash`, `python3` can be invoked. - All project paths are constrained to `/home/patron/apps`. - Preview binds to `127.0.0.1` (loopback). Expose it externally only via explicit SSH tunnel if desired. - Telemetry is disabled for Expo in preview (`EXPO_NO_TELEMETRY=1`). ## Troubleshooting - If `preview` says running but page doesn’t load: check the log file in `/home/patron/apps/_logs/`. - If a port is busy: set `EXPO_PORT` to a free port and re-run `preview`. - To stop preview: `kill $(cat /home/patron/apps/_state/<name>.pid)` (if pid exists).