---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/application-development

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Create or convert an application

# Create or convert an application with the ServiceNow SDK {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

Create an application or convert an existing application to develop in source code with the ServiceNow SDK.

## Antes de Iniciar

Install or upgrade the ServiceNow SDK using npm. For more information, see [Install the ServiceNow SDK in an application](https://servicenow-prod.fluidtopics.net/rPK7AYI56RlHePGrHbA~TQ "Install the ServiceNow software development kit (SDK) in a local application using Node Package Manager (npm).") or [Upgrade the ServiceNow SDK](https://servicenow-prod.fluidtopics.net/PLlUHAUWo8cM9qz2nAqCQQ "Upgrade to the latest version of the ServiceNow SDK for use with instances beginning with the Washington DC release.").

Use the ServiceNow SDK to authenticate to a ServiceNow instance. For more information, see [Authenticating to a ServiceNow instance with the ServiceNow SDK](https://servicenow-prod.fluidtopics.net/vl5mxRyynLXvgW_3_PtxYQ "Authenticate to a ServiceNow instance and store user credentials for accessing the instance on your system with the ServiceNow SDK.").

Role required: admin

## Por Que e Quando Desempenhar Esta Tarefa

This procedure uses the ServiceNow SDK command-line interface (CLI). From a command-line tool, enter `now-sdk --help` to get information about the available commands and global options. To get additional information about a
command and its parameters, enter the command and `--help` or `-h`. For example, `now-sdk auth --help`. For more information about the CLI, see [ServiceNow SDK CLI](https://servicenow-prod.fluidtopics.net/PRE3GTgYc~ImvC7_7y2WzA#servicenow-sdk-cli-commands "Use the ServiceNow SDK command-line interface (CLI) to manage changes between a local application and the application on an instance.").

## Procedimento

1. Create a local directory for your application.
2. In Visual Studio Code, open the directory.
3. From the application directory, open an integrated Terminal window.
4. Create an application following a guided set of prompts with the `init` command:  

       npx @servicenow/sdk init

   Nota:  
   Using the `npx` command installs the ServiceNow SDK in your application directory instead of globally.
5. Respond to the following series of prompts.  
   {#create-application-now-sdk__table_ivh_lzn_pdc__entry__2}

   | Prompt | Response |
   |-|-|
   | Select a template | Select a template that determines the default application structure, such as whether to create a full-stack application that supports UI development ands whether to use JavaScript or TypeScript to create modules. * Basic now-sdk boilerplate: An application with only the basic structure necessary for development in source code. * JavaScript now-sdk + basic: An application configured for development in ServiceNow Fluent and JavaScript. * JavaScript now-sdk + fullstack React: An application configured for development in ServiceNow Fluent, JavaScript, and React. * TypeScript now-sdk + basic: An application configured for development in ServiceNow Fluent and TypeScript. TypeScript source files in the src/server directory are transpiled into JavaScript modules. * TypeScript now-sdk + fullstack React: An application configured for development in ServiceNow Fluent, TypeScript, and React. TypeScript source files in the src/server directory are transpiled into JavaScript modules. {#create-application-now-sdk__ul_vj2_n4m_dgc} |
   | Name of ServiceNow Application | Enter a name for the application. |
   | NPM package name | Enter a name for the application package used in the package.json file. The package name must adhere to Node Package Manager (npm) package naming standards. |
   | Create a Global/Scoped App? | Select whether to create a scoped or global application. * Scoped: Create a scoped application that is protected by identifying and restricting access to application files and data. * Global: Create an application in the global scope to allow it to be accessible to other global applications. Global applications are supported only with instances beginning with the Australia release. {#create-application-now-sdk__ul_mbq_15t_m3c} |
   | Scope name | For scoped applications, enter the scope of the application. The scope name must be unique on the instance, begin with x_\<prefix\>, and be 18 characters or fewer. For more information, see [Namespace identifier](https://servicenow-prod.fluidtopics.net/CNFm~q~1Jp9ut0uVOsIlqw "The system adds a namespace identifier to the front of application artifacts such as tables, scripts, and configuration records."). |
   [ ]

   {#create-application-now-sdk__table_ivh_lzn_pdc}  
   In the following example, a scoped application named Example App (x_snc_example_app) is created.

       $ npx @servicenow/sdk init
       [now-sdk] Bootstrapping a new ServiceNow application project...
       ? Select a template: now-sdk + basic
       ? Name of ServiceNow Application:  Example App
       ? NPM package name:  example-app
       ? Scope name:  x_snc_example_app
       [now-sdk] Application created successfully.
                 Install the required dependencies with your preferred package manager before running "$now-sdk build".
                 Ex: Run "npm install" if using npm.

6. Install the required third-party dependencies using your preferred package manager.  
   For example, if you use Node Package Manager (npm), run `npm install`.
7. Build the application with the `build` command:  

       now-sdk build

8. **Opcional:** Install the application on an instance with the `install` command:  

       now-sdk install --auth <alias>

9. From the directory where you want to add an application, open a command-line tool on your system.
10. Create a scoped application or convert an existing application for use with the ServiceNow SDK.

    | Option | Steps |
    | Create a scoped application | 1. Create an application following a guided set of prompts using the `create` command: now-sdk create <scopeName>  --auth <alias> --interactive For example: now-sdk create x_snc_example --auth devuser1 --interactive Nota: The scope name must be unique on the instance, begin with x_\<prefix\>, and be 18 characters or fewer. For more information, see [Namespace identifier](https://servicenow-prod.fluidtopics.net/CNFm~q~1Jp9ut0uVOsIlqw "The system adds a namespace identifier to the front of application artifacts such as tables, scripts, and configuration records."). 2. Respond to the following prompts: * Name of the scoped application: <kbd class="ph userinput">&lt;application name&gt;</kbd> * Description associated with sys_app: <kbd class="ph userinput">&lt;description&gt;</kbd> * Project template? Select <kbd class="ph userinput">TypeScript</kbd> or <kbd class="ph userinput">JavaScript</kbd> * NPM package name: <kbd class="ph userinput">&lt;package name&gt;</kbd> * Add a sample table to the application? <kbd class="ph userinput">[Yes/No]</kbd> * Create Fluent or JS Module project structure? Select <kbd class="ph userinput">Fluent</kbd> or <kbd class="ph userinput">Module</kbd> This option determines the default application structure based on whether you want to use ServiceNow Fluent and JavaScript modules and third-party libraries in the application (`fluent`) or only use JavaScript modules and third-party libraries (`module`). {#create-application-now-sdk__ul_elw_qvl_pzb} {#create-application-now-sdk__ol_q3c_522_rzb} |
    | Convert an existing application | Convert an existing application from your instance using the `convert` command: now-sdk convert <scopeName> <packageName> --auth <alias> --projectType <type> Use the `--projectType` parameter to specify the type of application to create. This option determines the default application structure based on whether you want to use ServiceNow Fluent and JavaScript modules and third-party libraries in the application (`fluent`) or only use JavaScript modules and third-party libraries (`module`). For example: now-sdk convert x_snc_example example-app --auth devuser1 --projectType fluent Converting an application adds the necessary files and directories for using the ServiceNow SDK locally and downloads the application metadata. The application isn't changed on the instance until you build and install it on the instance. After installing a converted application, the Package JSON field of the custom application record \[sys_app\] contains the path to the package.json file for the application. |
    |-|-|

    {#create-application-now-sdk__choicetable_vzl_k22_rzb}

## Resultado

An application with the default application structure is available locally.
For information about the application structure, see the [Application structure](https://servicenow-prod.fluidtopics.net/fMFdQSnYXlXABQn6hWAbCQ#building-applications-source-code__application-structure) section of the Building applications in source code topic.

If you installed the application successfully, it's available on the instance. For more information about installing applications, see [Build and installdeploy an application with the ServiceNow SDK](https://servicenow-prod.fluidtopics.net/GCQJKq4yOxXXoDY~k7hdzw "Build and installdeploy a local application developed with the ServiceNow SDK on a ServiceNow instance.").

If the application is built and installed to the instance, the CLI returns the URL to the application, such as
https://myinstance.service-now.com/sys_app.do?sys_id=\<sysID\>. If you chose not to build and register the application on the instance during creation, the application isn't installed to the instance until you do so. For more information, see [Build and installdeploy an application with the ServiceNow SDK](https://servicenow-prod.fluidtopics.net/GCQJKq4yOxXXoDY~k7hdzw "Build and installdeploy a local application developed with the ServiceNow SDK on a ServiceNow instance.").

## O que Fazer Depois

In Visual Studio Code, start developing your application in source code with ServiceNow Fluent, writing custom JavaScript modules, or adding third-party libraries. For more information, see [Developing applications with the ServiceNow SDK](https://servicenow-prod.fluidtopics.net/xctR54vl0a5pA9nq6vA5hQ "Create and develop applications in source code locally in Visual Studio Code Desktop with the ServiceNow SDK. Build and install applications to make your changes available on an instance.").