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).