Mobile Dev Workflow

Control your development workflow from your phone. Laptop only hosts the dev server.

Start session

Use this when starting a new mobile-controlled dev session.

cd C:\Dev\Apps\[app]
git checkout main
git pull origin main
git checkout -b [branchnaam]
git push -u origin [branchnaam]
npm run dev

Open Expo Go on iPhone and connect to the running dev server.

Agent loop

Use Cursor Agents to make changes on the GitHub branch. Then pull locally and check the result in Expo Go.

git pull origin [branchnaam]

Repeat after every agent change.

Check the result in Expo Go on iPhone.

If not good yet, send another Cursor Agent prompt on the same branch, then pull again locally.

Cursor Agent prompt rules

Use these rules in your prompt so the agent behaves safely.

Work on branch: [branchnaam]
Do not use main.
Commit changes only to this branch.
Do not merge into main.
Keep changes minimal and targeted.
Work on branch: [branchnaam]. Do not use main. Commit changes only to this branch. Do not merge into main. Keep changes minimal and targeted.

Merge branch when approved

Only do this after checking the change in Expo Go.

git checkout main
git pull origin main
git merge [branchnaam]
git push origin main

Optional cleanup after successful merge

git branch -d [branchnaam]
git push origin --delete [branchnaam]

Delete branch if not good

Use this if the branch direction is wrong and you want to discard it.

git checkout main
git branch -D [branchnaam]
git push origin --delete [branchnaam]

Quick rules

Cursor Agents work on GitHub, not on local files.

After every agent change, pull locally before checking in Expo Go.

Expo Go is the visual source of truth.

Never let agents work on main.

Use branch prefixes: design/..., feature/..., experiment/...

Example branch names

design/onboarding-spacing
feature/decimal-weight-input
experiment/goal-first-onboarding

Full flow summary

Laptop on

SSH into laptop with Termius

Go to repo

Pull latest main

Create branch

Push branch to GitHub

Start dev server

Let Cursor Agent make changes on that branch

Pull branch locally

Check in Expo Go

Iterate until good

Merge if approved

Delete if not good