Building mobile apps with Reactive-ns
An opinionated NativeScript + React 19 starter template powered by Vite.

Screenshots

Feed & Filters	Story Details	Comments Sheet Modal	Settings

Features

• ⚡️ React 19, NativeScript 9, Vite, pnpm - modern native mobile development powered by lightning-fast Vite bundler

• 🔄 @nativescript-community/react & DOMiNATIVE - native DOM document implementation bridging React 19 reconciler to NativeScript view tree

• 🎨 Tailwind CSS v4 - utility-first styling with @nativescript/tailwind for styling native mobile components

• 😃 unplugin-icons & @nativescript-community/ui-svg - on-demand vector icons with custom SVG compiler and dev-server HTTP loader bridge

• 🔤 Self-hosted fonts

• 🛠️ mise toolchain - pre-configured Android SDK, Java 17, and emulator commands

• 🦾 TypeScript - fully typed components, custom JSX intrinsic elements, and NativeScript definitions

• 🧪 Vitest - fast unit testing, available through pnpm react test

• 🤖 Agent-ready - comprehensive AGENTS.md context and built-in NativeScript skills for AI coding assistants

Try it now!

Reactive-ns requires Node >=20.x, pnpm >=10.x, and NativeScript environment setup.

Clone to local

git clone https://github.com/ws-rush/reactive-ns.git
cd reactive-ns
pnpm install

Development

Run the app on an Android device or emulator:

pnpm react ns run android

Run on iOS (macOS required):

pnpm react ns run ios

NativeScript commands

Use pnpm react ns to run NativeScript CLI commands for the React app:

Command	Purpose
pnpm react ns prepare android	Sync native Android project files and install native dependencies.
pnpm react ns run android	Build, install, and launch the app on a connected device or emulator.
pnpm react ns build android	Create a production Android build without launching it.
pnpm react ns debug android	Launch the app with the NativeScript debugging tools attached.
pnpm react ns clean	Remove generated build artifacts before a fresh build.

Replace android with ios on macOS where supported.

Run unit tests with pnpm react test (or pnpm react test -- --run for a single run).

Android Toolchain with mise

If using mise to manage your Android toolchain:

# Install toolchain
mise install

# List available emulators
mise exec -- emulator -list-avds

# Launch emulator
mise exec -- emulator -avd <your_avd_name>