NativeScript — Build Truly Native iOS and Android Apps with JavaScript or TypeScript

What it is

NativeScript is an open-source framework for building native iOS and Android apps with JavaScript or TypeScript. Unlike hybrid frameworks that wrap web content in a WebView, NativeScript renders actual native UI widgets. It provides direct access to every iOS and Android API from JavaScript, with no bridge overhead for simple API calls.

NativeScript targets mobile developers who want native performance and platform API access while writing in JavaScript or TypeScript. It supports Angular, Vue, Svelte, and React as UI frameworks, or you can use plain TypeScript.

How it saves time or tokens

NativeScript uses one codebase for both iOS and Android while rendering native UI components. You avoid maintaining separate Swift/Kotlin codebases. Direct API access means you call platform APIs from JavaScript without writing native plugins for common tasks. The CLI provides hot reload during development, and the framework handles platform-specific adaptations automatically.

How to use

1. Install the CLI with npm install -g @nativescript/cli and run ns doctor to verify your development environment (Xcode, Android SDK).
2. Create a new app with ns create hello --template @nativescript/template-blank-ts.
3. Run on a simulator or device with ns run ios or ns run android.

Example

# Install CLI
npm install -g @nativescript/cli
ns doctor

# Create app with TypeScript template
ns create my-app --template @nativescript/template-blank-ts
cd my-app

# Run on iOS simulator
ns run ios

# Run on Android emulator
ns run android

// app/main-view-model.ts
import { Observable } from '@nativescript/core';

export class MainViewModel extends Observable {
  private _counter = 0;

  get message(): string {
    return `Tapped ${this._counter} times`;
  }

  onTap(): void {
    this._counter++;
    this.notifyPropertyChange('message', this.message);
  }
}

Related on TokRepo

• Coding AI Tools — Developer productivity and framework tools
• Automation Tools — Build and deployment automation

Common pitfalls

• NativeScript requires Xcode for iOS builds and Android SDK for Android builds. You cannot build iOS apps on Windows or Linux.
• Some npm packages that rely on browser APIs (DOM, window) do not work in NativeScript. Check plugin compatibility before depending on web-oriented packages.
• Performance-sensitive animations should use the NativeScript animation API rather than JavaScript timers. The animation API runs on the native UI thread.