NativeScript empowers you to access native APIs from JavaScript directly. Currently iOS, Android, and visionOS runtimes are provided for rich mobile development across a variety of diverse use cases.

To get started with NativeScript, follow these steps:

1. Install the NativeScript CLI globally:

   npm install -g nativescript

2. Create a new project:

   ns create my-app

3. Navigate into your project directory:

   cd my-app

4. Run your app on an emulator or device:

   ns run android

   or

   ns run ios

If you encounter errors when using the NativeScript CLI, try the following solutions:

• Environment Setup Issues:
  Ensure Node.js (v14.x or later) and the NativeScript CLI are installed properly.
  Run ns doctor to diagnose environment problems.

• Emulator Connection Errors:
  Verify that your Android or iOS emulator is running and accessible.
  Restart the emulator or device if needed.

• Plugin Installation Failures:
  Check internet connectivity and retry npm install.
  Clear npm cache if problems persist: npm cache clean --force.

Feel free to open issues if you need more assistance.

1. Setup your local development environment

2. Clone to contribute:

$ git clone https://github.com/NativeScript/NativeScript.git
$ cd NativeScript

# setup workspace for development
$ npm run setup

# list all available commands to run
$ npm start

We love you and your pull requests 🤗. Please follow our contributing guide and see our code of governance to become as involved as you want to be. NativeScript empowers you to access native APIs from JavaScript directly, enabling rich mobile application development across iOS, Android, and visionOS platforms.

• @nativescript/core Singular primitives offering an easy-to-use API surface for diverse iOS/visionOS/Android APIs implemented with NativeScript.
• @nativescript/types Types for both iOS/Android below wrapped up as a convenience. Most commonly used.
• @nativescript/types-ios Types for iOS.
• @nativescript/types-android Types for Android.
• @nativescript/types-minimal A very minimal set of types for only the latest Android and iOS sdks. Most commonly used to optimize Web-based IDE's which auto load all type declarations from node_modules.
• @nativescript/ui-mobile-base UI mobile base native classes used by core.
• @nativescript/webpack Webpack build utilities and configs used by NativeScript apps.

• NativeScript Home
• NativeScript Tutorials
• NativeScript documentation
• JavaScript starter: https://nativescript.new/javascript
• TypeScript starter: https://nativescript.new/typescript
• Angular starter: https://nativescript.new/angular
• React starter: https://nativescript.new/react
• Solid starter: https://nativescript.new/solid
• Svelte starter: https://nativescript.new/svelte
• Vue starter: https://nativescript.new/vue
• Vue 3 starter: https://nativescript.new/vue3
• NativeScript on Twitter
• NativeScript on Discord
• NativeScript on Stack Overflow

Outside the source centralized in this repo, NativeScript consists of a few other source repos. Here are the major ones:

• iOS and visionOS Runtime Empowers JavaScript code to be executed on iOS and visionOS devices written in a mix of C++, Objective-C, and Swift.
• Android Runtime Empowers JavaScript code to be executed on Android devices written in a mix of C++, Java and Kotlin.
• CLI Command-line interface empowering you to create, build, and run apps using NativeScript.
• Docs Documentation available at http://docs.nativescript.org/ written in Markdown.
• Plugins Various TSC managed plugins. Also a good reference is the plugin marketplace with several additional plugins.
• Firebase Modular Firebase 🔥 implementation for supported platforms.
• ML Kit Google's ML Kit SDKs for supported platforms.
• Payments In-App Purchase, Subscriptions, Google Pay and Apple Pay.
• Artwork Want to use our logo or colors? Feel free to use any of our ready-to-use media material.

The NativeScript project consists of multiple repositories focused on different platforms and functionalities:

iOS and visionOS Runtime: JavaScript execution on iOS and visionOS devices (C++, Objective-C, Swift)

Android Runtime: JavaScript execution on Android devices (C++, Java, Kotlin)

CLI: Command-line interface to create, build, and run NativeScript apps

Docs: Documentation in Markdown

Plugins: Official plugins and plugin marketplace

Firebase: Modular Firebase implementation

ML Kit: Google’s ML Kit SDKs support

Payments: In-app purchase and payment integration

Artwork: Media assets like logos and branding material

Copyright OpenJS Foundation and NativeScript contributors. All rights reserved. The OpenJS Foundation has registered trademarks and uses trad>

The OpenJS Foundation | Terms of Use | Privacy Policy | [OpenJS Foundation Bylaws](https:>

Made with ❤️ by NativeScript Contributors