<% if (isJekyll) { %>--- title: ns plugin install position: 3 ---<% } %> # ns plugin install ### Description <% if(isConsole) { %>Installs the specified plugin and any packages that it depends on.<% } %> <% if(isHtml) { %>Installs the specified plugin and its dependencies in the local `node_modules` folder, adds it to the `dependencies` section in `package.json`, and prepares the plugin for all installed platforms. If you have not configured any platforms for the project, the NativeScript CLI will prepare the plugin when you add a platform. For more information about working with plugins, see [NativeScript Plugins](https://github.com/NativeScript/nativescript-cli/blob/master/PLUGINS.md).<% } %> ### Commands Usage | Synopsis ------|------- General | `$ ns plugin install ` Alias | `$ ns plugin add ` ### Arguments * `` is a valid NativeScript plugin, specified by any of the following. * A `` or `@` where `` is the name of a plugin that is published in the npm registry and `` is a valid version of this plugin. * A `` to the directory which contains the plugin, including its `package.json` file. * A `` to a `.tar.gz` archive containing a directory with the plugin and its `package.json` file. * A `` which resolves to a `.tar.gz` archive containing a directory with the plugin and its `package.json` file. * A `` which resolves to a `.tar.gz` archive containing a directory with the plugin and its `package.json` file. <% if(isHtml) { %> ### Prerequisites * Verify that the plugin that you want to add contains a valid `package.json` file. Valid `package.json` files contain a `nativescript` section. ### Related Commands Command | Description ----------|---------- [plugin](plugin.html) | Lets you manage the plugins for your project. [plugin add](plugin-add.html) | Installs the specified plugin and its dependencies. [plugin remove](plugin-remove.html) | Uninstalls the specified plugin and its dependencies. <% } %>