Skip to content

Latest commit

 

History

History
35 lines (29 loc) · 3.98 KB

create.md

File metadata and controls

35 lines (29 loc) · 3.98 KB

create

Usage Synopsis
Create from default JavaScript template $ tns create <App Name> [--path <Directory>] [--appid <App ID>]
Create from default TypeScript template $ tns create <App Name> --template typescript [--path <Directory>] [--appid <App ID>] OR $ tns create <App Name> --template tsc [--path <Directory>] [--appid <App ID>]
Create from default Angular template $ tns create <App Name> --template angular [--path <Directory>] [--appid <App ID>] OR $ tns create <App Name> --template ng [--path <Directory>] [--appid <App ID>] OR $ tns create <App Name> --ng [--path <Directory>] [--appid <App ID>]
Copy from existing project $ tns create <App Name> [--path <Directory>] [--appid <App ID>] --copy-from <Directory>
Create from custom template $ tns create <App Name> [--path <Directory>] [--appid <App ID>] --template <Template>

Creates a new project for native development with NativeScript.

Options

  • --path - Specifies the directory where you want to create the project, if different from the current directory. The directory must be empty.
  • --appid - Sets the application identifier for your project.
  • --copy-from - Specifies a directory which contains an existing NativeScript project. If --copy-from and --template are not set, the NativeScript CLI creates the project from the default JavaScript hello-world template.
  • --template - Specifies a valid npm package which you want to use to create your project. If --copy-from and --template are not set, the NativeScript CLI creates the project from the default JavaScript hello-world template.<% if(isHtml) { %> If one or more application assets are missing from the App_Resources directory in the package, the CLI adds them using the assets available in the default hello-world template.<% } %>
  • --ng - Sets the template for your project to the Angular template.

Attributes

  • <App Name> is the name of project. The specified name must meet the requirements of all platforms that you want to target. <% if(isConsole) { %>For more information about the <App Name> requirements, run $ tns help create<% } %><% if(isHtml) { %>For projects that target Android, you can use uppercase or lowercase letters, numbers, and underscores. The name must start with a letter. For projects that target iOS, you can use uppercase or lowercase letters, numbers, and hyphens.<% } %>
  • <App ID> is the application identifier for your project. It must be a domain name in reverse and must meet the requirements of all platforms that you want to target. If not specified, the application identifier is set to org.nativescript.<App name> <% if(isConsole) { %>For more information about the <App ID> requirements, run $ tns help create<% } %><% if(isHtml) { %>For projects that target Android, you can use uppercase or lowercase letters, numbers, and underscores in the strings of the reversed domain name, separated by a dot. Strings must be separated by a dot and must start with a letter. For example: com.nativescript.My_Andro1d_App For projects that target iOS, you can use uppercase or lowercase letters, numbers, and hyphens in the strings of the reversed domain name. Strings must be separated by a dot. For example: com.nativescript.My-i0s-App.
  • <Template> is a valid npm package which you want to use as template for your app. You can specify the package by name in the npm registry or by local path or GitHub URL to a directory or .tar.gz containing a package.json file. The contents of the package will be copied to the app directory of your project.<% } %>

<% if(isHtml) { %>

Related Commands

Command Description
init Initializes a project for development. The command prompts you to provide your project configuration interactively and uses the information to create a new package.json file or update the existing one.
install Installs all platforms and dependencies described in the package.json file in the current directory.
<% } %>