Melvynx/saveit.now / .agents/skills/ns-preview
ns-preview
VerifiedMirror an explicit NowStack iOS Simulator through serve-sim into a live browser preview, then drive the app from that browser. Use for `/ns preview`, showing the Expo app, or collecting browser-visible mobile UI proof.
NS Preview
One workflow, any harness
There is no host-specific path. Every agent runs the same four things: get a UDID, get the app rendering, start serve-sim, open the URL in a controllable browser. If the harness has no browser it can drive, run open "<url>" for the user and label the browser stream NOT VERIFIED.
1. Pick one explicit UDID
xcrun simctl list devices available
Never pass booted once more than one Simulator may be active. Every later simctl call in the session addresses that same UDID.
2. Get the app actually rendering
Boot the device, install the build, start Metro on an explicit port, launch, and point the dev client at Metro. ns-ios-verification owns this; the short form is:
SIM="<simulator-udid>"
BUNDLE_ID="$(/usr/libexec/PlistBuddy -c 'Print :CFBundleIdentifier' "<path-to>.app/Info.plist")"
xcrun simctl boot "$SIM"; xcrun simctl bootstatus "$SIM" -b
xcrun simctl install "$SIM" "<path-to>.app"
xcrun simctl launch "$SIM" "$BUNDLE_ID"
xcrun simctl openurl "$SIM" "<slug>://expo-development-client/?url=http%3A%2F%2Flocalhost%3A8081"
Read the bundle id from the installed Info.plist rather than from site-config.ts. An older dev build can carry a stale bundle id, and simctl launch with the config value fails with FBSOpenApplicationServiceErrorDomain code=4. When the two disagree, say so in the report: JS still streams from Metro, but nothing native or config-level since that build is present. The fix is cd mobile-app && npm run ios.
3. Start the mirror, scoped to that UDID
Keep it in its own long-running terminal. serve-sim exits when the device shuts down under it (FrameCapture Code=2 "Device not booted"), so supervise it rather than assuming one start lasts the session:
SIM="<simulator-udid>"
cleanup_serve_sim() {
npx --yes serve-sim@latest --kill "$SIM" >/dev/null 2>&1 || true
}
trap 'cleanup_serve_sim; exit 0' EXIT INT TERM HUP
cleanup_serve_sim
while true; do
if [ "$(xcrun simctl list devices | grep "$SIM" | grep -c Booted)" -eq 0 ]; then
sleep 3
continue
fi
npx --yes serve-sim@latest --host 127.0.0.1 "$SIM"
cleanup_serve_sim
sleep 3
done
Wait for readiness before opening anything:
until curl -sf --max-time 3 -o /dev/null http://127.0.0.1:3200; do sleep 2; done
4. Open the printed URL in a controllable browser
Use the exact URL serve-sim prints. Take a screenshot and confirm a real Simulator frame with app content, not just a page shell. A live badge, the device name, and recognizable app UI are the proof. HTTP 200 is not.
Driving the app from the browser
The mirror is a real input channel. Clicking and scrolling in it is normal preview interaction, not computer-use, and it is the fastest way to walk a screen and confirm a change landed. Use it freely for app UI.
Two limits worth knowing:
- Simulator system layers do not receive mirror taps. iOS alerts such as "Apple Account Verification" float above the app and swallow clicks sent through the preview. Get back to the app with
xcrun simctl terminate "$SIM" "$BUNDLE_ID"thenlaunch, rather than clicking at the alert repeatedly. - Route setup stays on
simctl. For a specific screen, deep link it (xcrun simctl openurl "$SIM" "<slug>://(app)/(tabs)/<route>", route group segment included) instead of tapping through navigation. Deterministic beats pixel-hunting.
Never type credentials, API keys, or personal data into the mirrored Simulator, and never complete a system sign-in sheet that appears there. Back out with Cancel and relaunch the app.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |