Skip to content
Branch: master
Find file History
Type Name Latest commit message Commit time
Failed to load latest commit information.
hooks/after-createProject fix: after-createProject hook (#13) Feb 13, 2019
tools chore: migrate template to version 2 (#65) Jan 9, 2019
.editorconfig chore: add .editorconfig and tsfmt.json files (#16) Mar 5, 2019
.gitignore chore: webpack only workflow (#46) Jun 22, 2019
.npmignore chore: webpack only workflow (#46) Jun 22, 2019 Update Jan 14, 2019
package.json chore: merge release to master (#69) Jul 24, 2019
tsconfig.json feat: skipLibCheck for ts templates (#71) Aug 1, 2019
tsconfig.tns.json chore: webpack only workflow (#46) Jun 22, 2019
tsfmt.json chore: add .editorconfig and tsfmt.json files (#16) Mar 5, 2019
tslint.json chore: add deprecation tslint rule (#21) Mar 21, 2019

NativeScript Core with TypeScript Master Detail Template

App templates help you jump start your native cross-platform apps with built-in UI elements and best practices. Save time writing boilerplate code over and over again when you create new apps.

This Master-Detail template is a fundamental building block for any app that displays collection of objects and their details and need to work both in online and offline mode while utilizing Kinvey as a backend. The template uses a RadListView component to display the master list. The RadListView component is part of Progress NativeScript UI.

Key Features

  • Editable master-detail interface
  • Integration with Kinvey database
  • Works offline
  • Customizable theme
  • UX and development best practices
  • Easy to understand code

Quick Start

Execute the following command to create an app from this template:

tns create my-master-detail-kinvey-ts --template tns-template-master-detail-kinvey-ts

Note: This command will create a new NativeScript app that uses the latest version of this template published to [npm] (

If you want to create a new app that uses the source of the template from the master branch, you can execute the following:

# clone nativescript-app-templates monorepo locally
git clone

# create app template from local source (all templates are in the 'packages' subfolder of the monorepo)
tns create my-master-detail-kinvey-ts --template nativescript-app-templates/packages/template-master-detail-kinvey-ts



The template has the following pages:

  • /cars/cars-list-page.ts - the master list page. It gets the data and displays it in a list. On item tap, it navigates to the item details page.
  • /cars/car-detail-page/car-detail-page.ts - the item details page. Displays the details of the tapped item. Has an Edit button that leads to the edit page.
  • /cars/car-detail-edit-page/car-detail-edit-page.ts - the item details edit page. Provides edit options for the selected item. The Done button saves the changes.

There is one model to represent the data items:

  • /cars/shared/car-model.ts

The template also provides a data service:

  • /cars/shared/car-service.ts - serves as a data layer for the master-detail data items. Wraps the functions that are used to make operations on the Kinvey database.

Kinvey integration

The templates uses the {N} Kinvey plugin. The initialization is done before the app starts in the /app.ts file. The initialization script is located at /shared/kinvey.common.ts.

[Optional] Kinvey database setup

By design the app is connected to a read-only copy of the sample data in Kinvey. If you want to see the "edit" functionality in action you will have to clone the sample data and update the app configuration to point to your own Kinvey setup. You can find detailed instructions how to achieve that here.


This template is set up to use SASS for styling. All classes used are based on the {N} core theme – consult the documentation to understand how to customize it. Check it out to see what classes you can use on which component.

It has 4 global style files that are located at the root of the app folder:

  • _app-variables.scss - holds the global SASS variables that are imported on each component's styles.
  • app.scss - the global common style sheet. These style rules are applied to both Android and iOS.
  • - the global Android style sheet. These style rules are applied to Android only.
  • platform.ios.scss - the global iOS style sheet. These style rules are applied to iOS only.

Each component has 3 style files located in its folder:

  • _page-name.scss - the component common style sheet. These style rules are applied to both Android and iOS.
  • - the component Android style sheet. These style rules are applied to Android only.
  • page-name.ios.scss - the component iOS style sheet. These style rules are applied to iOS only.

Get Help

The NativeScript framework has a vibrant community that can help when you run into problems.

Try joining the NativeScript community Slack. The Slack channel is a great place to get help troubleshooting problems, as well as connect with other NativeScript developers.

If you have found an issue with this template, please report the problem in the NativeScript repository.


We love PRs, and accept them gladly. Feel free to propose changes and new ideas. We will review and discuss, so that they can be accepted and better integrated.

NB: Please, have in mind that the master branch may refer to dependencies that are not on NPM yet!

You can’t perform that action at this time.