nativescript-app-templates/packages/template-drawer-navigation-ng
Stoyan Stratev 1b13dc9201 chore(release): publish
- tns-template-blank-ng@6.3.1
 - tns-template-blank-ts@6.3.1
 - tns-template-blank-vue@6.3.1
 - tns-template-blank@6.3.1
 - tns-template-drawer-navigation-ng@6.3.1
 - tns-template-drawer-navigation-ts@6.3.1
 - tns-template-drawer-navigation-vue@6.3.1
 - tns-template-drawer-navigation@6.3.1
 - tns-template-hello-world-ng@6.3.1
 - tns-template-hello-world-ts@6.3.1
 - tns-template-hello-world@6.3.1
 - tns-template-master-detail-kinvey-ng@6.3.1
 - tns-template-master-detail-kinvey-ts@6.3.1
 - tns-template-master-detail-kinvey@6.3.1
 - tns-template-master-detail-ng@6.3.1
 - tns-template-master-detail-ts@6.3.1
 - tns-template-master-detail-vue@6.3.1
 - tns-template-master-detail@6.3.1
 - tns-template-tab-navigation-ng@6.3.1
 - tns-template-tab-navigation-ts@6.3.1
 - tns-template-tab-navigation-vue@6.3.1
 - tns-template-tab-navigation@6.3.1
2020-01-02 15:09:08 +02:00
..
App_Resources fix(android): apptheme on api level 29 (#136) 2019-11-12 15:25:22 +02:00
hooks/after-createProject fix(hook): use synchronous operations in after-createProject (#144) 2019-11-19 14:08:38 +02:00
src fix(hook): use synchronous operations in after-createProject (#144) 2019-11-19 14:08:38 +02:00
tools fix(vscode): copy extensions.json to output project (#141) 2019-11-15 11:51:11 +02:00
.editorconfig chore: add .editorconfig and tsfmt.json files (#16) 2019-03-05 17:48:49 +02:00
.gitignore chore: webpack only workflow (#46) 2019-06-22 07:25:20 -07:00
.npmignore chore: webpack only workflow (#46) 2019-06-22 07:25:20 -07:00
README.md chore: update template readme files (#131) 2019-11-04 13:27:45 +02:00
angular.json chore: add .editorconfig and tsfmt.json files (#16) 2019-03-05 17:48:49 +02:00
nsconfig.json chore: remove useLegacyWorkflow from settings (#74) 2019-08-12 11:51:03 +03:00
package.json chore(release): publish 2020-01-02 15:09:08 +02:00
tsconfig.json feat: skipLibCheck for ts templates (#71) 2019-08-01 15:26:00 +03:00
tsconfig.tns.json chore: ng v8 new loadChildren import syntax (#93) 2019-09-12 01:00:22 +03:00
tsfmt.json chore: add .editorconfig and tsfmt.json files (#16) 2019-03-05 17:48:49 +02:00
tslint.json fix(hook): use synchronous operations in after-createProject (#144) 2019-11-19 14:08:38 +02:00

README.md

NativeScript with Angular Drawer Navigation 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.

App template featuring a RadSideDrawer component for navigation. The RadSideDrawer component is part of Progress NativeScript UI.

Key Features

  • Side drawer navigation
  • Five blank pages hooked to the drawer navigation
  • 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-drawer-ng --template tns-template-drawer-navigation-ng

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 git@github.com:NativeScript/nativescript-app-templates.git

# create app template from local source (all templates are in the 'packages' subfolder of the monorepo)
tns create my-drawer-ng --template nativescript-app-templates/packages/template-drawer-navigation-ng

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

Walkthrough

Architecture

The RadSideDrawer component is set up as an application root view in:

  • /src/app/app-component - sets up the side drawer content and defines a page router outlet for the pages.

RadSideDrawer has the following component structure:

  • RadSideDrawer - The component to display a drawer on the page.
  • tkDrawerContent directive - Marks the component that will hold the drawer content.
  • tkMainContent directive - Marks the component that will hold the app main content.

There are five blank components located in these folders:

  • /src/app/browse/browse.component
  • /src/app/featured/featured.component
  • /src/app/home/home.component
  • /src/app/search/search.component
  • /src/app/settings/settings.component

Styling

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.

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

  • /src/_app-common.scss - the global common style sheet. These style rules are applied to both Android and iOS.
  • /src/app.android.scss - the global Android style sheet. These style rules are applied to Android only.
  • /src/app.ios.scss - the global 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.

Contributing

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.