Sitelet https://github.com/NativeScript/angular
Skip to content

Repository files navigation

NativeScript Angular

Monorepo for Angular integration with NativeScript, enabling you to build native iOS, Android and visionOS apps with Angular.

Packages

Package Version Description
@nativescript/angular npm The Angular integration for NativeScript: renderer, router integration, dialogs, list view templates, zone setup and application bootstrap.
@nativescript/zone-js npm NativeScript-specific patches for zone.js so Angular change detection works with native APIs.

The workspace also contains apps/nativescript-demo-ng, a demo app used to develop and test the packages.

See DevelopmentWorkflow.md for more details on contributing.

Development

Clean and setup workspace:

npm run clean.all

Build packages:

npm run build

Run demo:

npm run demo.ios
// or...
npm run demo.android

Clean/Reset demo dependencies:

npm run demo.clean

Unit tests for iOS and Android:

npm run test.android
npm run test.ios

Releasing

Releases are managed with Nx Release. Each package is released independently:

npm run release.angular
npm run release.zone-js

This will build the package, prompt for the new version (or accept it as an argument, e.g. npm run release.angular -- 22.0.0), update the package's changelog (packages/angular/CHANGELOG.md or packages/zone-js/CHANGELOG.md), commit as release: <version>, tag as <package>@<version> (e.g. angular@22.0.0, zone-js@4.0.1), push, create the GitHub release and publish to npm from dist/packages/*.

Useful flags (pass after --):

  • --dry-run — preview everything without changing anything
  • --skip-publish — do everything except publish to npm

A GITHUB_TOKEN environment variable (e.g. GITHUB_TOKEN=$(gh auth token)) is required to create the GitHub release non-interactively.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages