/NativeScript

NativeScript is an open source framework for building truly native mobile apps with JavaScript. Use web skills, like Angular and Vue.js, FlexBox and CSS, and get native UI and performance on iOS and Android.

Primary LanguageTypeScriptApache License 2.0Apache-2.0

NativeScript Build Status

NativeScript logo

NativeScript is a framework for building native iOS and Android apps using JavaScript and CSS. NativeScript renders UIs with the native platform’s rendering engine, no WebViews, resulting in native-like performance and UX.

NativeScript provides a best-of-both-worlds development experience. Our cross-platform JavaScript modules give you the convenience of writing iOS and Android apps from a single JavaScript codebase, while our runtimes give you the power of accessing native APIs, SDKs, and frameworks when you need them—all without needing to open Xcode or Android Studio. NativeScript was created and is supported by Telerik.

Check out the links below to get started:

IMPORTANT: NativeScript is an inclusive community, and we expect all NativeScript community members, users, and contributors to treat each other respectfully. As such, all users of this repository must adhere to the NativeScript community code of conduct.

For CTOs

Making the right technology choices is key to success. Our CTO’s guide to NativeScript helps you understand why NativeScript is the right choice for your next mobile project.

Getting Started and Installation

Our Getting Started Guides are hands-on tutorials that walk you through installing NativeScript and building a real iOS and Android application.

NativeScript architecture diagram

Below is a common NativeScript architecture diagram. In more detail, read the How NativeScript Works article.

Architecture diagram

Quick Links

Repositories

The NativeScript framework consists of a number of components, all of which are open source and on GitHub. Here are the major ones:

  • Cross-platform modules npm Waffle.io - NativeScript Modules and Angular
    • This repo contains the NativeScript cross-platform modules, which abstract iOS and Android APIs into JavaScript APIs—e.g. camera.takePicture(). The modules are written in TypeScript.
  • iOS runtime npm Waffle.io - NativeScript iOS Runtime
    • This repo contains the NativeScript iOS runtime—the code that hosts NativeScript iOS apps, and allows JavaScript code to be executed on iOS devices. The iOS runtime is written in a fun mix of C++, Objective-C, and more.
  • Android runtime npm Waffle.io - NativeScript Runtimes and CLI
    • This repo contains the NativeScript Android—the code that hosts NativeScript Android apps, and allows JavaScript code to be executed on Android devices. The Android runtime is written in a fun mix of C++ and Java.
  • CLI npm Waffle.io - NativeScript CLI
    • This repo contains the NativeScript command-line interface, which lets you create, build, and run apps using the NativeScript framework. The CLI is written in TypeScript.
  • Docs
    • This repo contains the NativeScript framework documentation, which is available at http://docs.nativescript.org/. The docs are written in Markdown.

In addition to the code that makes up the NativeScript framework itself, we also provide a number of open-source sample apps that you can reference while building your NativeScript application.

Contributing

We love PRs, and accept them for all of our repositories—even docs! Please follow our contribution guide if you want to become part of the project.

Angular

We worked together with the Google Angular team to make Angular 2+ work on top of NativeScript. To use Angular with NativeScript please follow the getting started article.

Get Help

Please, use github issues strictly for reporting a bugs or requesting features. For general NativeScript questions and support, check out Stack Overflow or ask our experts in NativeScript community Slack channel.