React Native Preview

CLI to preview a React Native app locally in the browser.

Installation

Use directly with npx:

npx react-native-viewlet start

Or install globally:

npm install -g react-native-viewlet
rnv start

Usage

Run from the root of an existing React Native project:

npx rnv start

Options:

npx rnv start --port 5000
npx rnv start --entry ./src/App.tsx
npx rnv start --device iphone
npx rnv start --device android
npx rnv start --no-open
rnv --version
rnv --help

What it does

• Starts a local preview server (default: http://localhost:4000)
• Detects a React Native entry file automatically
• Transpiles RN source to browser-compatible code
• Reloads preview automatically on source changes

Local publish verification checklist

• Run lint and tests:

npm run lint
npm test -- --runInBand

• Check npm package name availability:

npm run release:check:name

• Validate CLI entrypoint and local linking flow:

npm run release:check:link
npm link
rnv --version

• Check package content:

npm pack --dry-run

• Run full release preparation script:

npm run release:prepare

• Validate CLI in a sample project:

node ./bin/rnv.js start --no-open --port 5055

Distribution notes

• Package name: react-native-viewlet
• Bin aliases: rnv, react-native-viewlet
• Runtime target: Node.js 20+
• Versioning policy: SemVer

License

MIT