---
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


---

# Convert an application

# Convert an application with the ServiceNow IDE {#ariaid-title1}

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

Convert an existing application to support development in source code with the ServiceNow IDE.

## Antes de Iniciar

Create a workspace for your applications. For more information, see [Create a workspace in the ServiceNow IDE](https://servicenow-prod.fluidtopics.net/uRgK8LMq32KHUsQgoHY3Mw "Create a workspace to view and organize the applications you're working on in the ServiceNow IDE.").

Role required: admin  
Nota:  
With ServiceNow IDE version 3.1.4 and earlier, the sn_glider.ide_fluent_admin role is also required to convert applications.

## Por Que e Quando Desempenhar Esta Tarefa

Existing applications that weren't created with the ServiceNow IDE or ServiceNow SDK must be converted to support development in source code. Converting an application adds the necessary files and directories for developing it in source code. You can choose whether to convert existing application metadata into ServiceNow Fluent code.{#convert-application-servicenow-ide__convert-desc}

## Procedimento

1. Navigate to AllApp DevelopmentServiceNow IDE.
2. Open a workspace.
3. Use one of the following keyboard shortcuts to open the command palette:  
   * Windows: Ctrl-Shift-P
   * Mac: Cmd-Shift-P
   {#convert-application-servicenow-ide__ul_j4x_ns4_gcc}
4. Enter <kbd class="ph userinput">Fluent: Convert an app to Fluent</kbd> and press Enter.
5. Select an application from the list.  
   Applications that haven't been converted are listed as Code Ready: FalseIs Fluent app: False.  
   The application is added to your workspace with the default application structure but the application metadata isn't converted into ServiceNow Fluent code. 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.
6. **Opcional:** To convert existing metadata into ServiceNow Fluent code, complete the following steps.
   1. From the Activity Bar, select the File Explorer view (![File Explorer]()).
   2. Right-click the metadata directory for the application and select Convert Directory to Fluent.  

   {#convert-application-servicenow-ide__substeps_l4w_phm_ydc}  
   Application metadata is defined in ServiceNow Fluent code in the fluent/generated directory and removed from the metadata directory and its sub-directories.

   Nota:  
   A limited number of metadata types, such as Metadata Snapshots \[sys_metadata_link\] and UX Assets \[sys_ux_lib_asset\], can't be represented as ServiceNow Fluent code and aren't transformed. These metadata types remain as metadata XML files in the metadata directory of your application.
7. **Opcional:** Build and installdeploy your application to compile source code into application metadata and make your changes available across the instance. For more information, see [Build and install an application in the ServiceNow IDE](https://servicenow-prod.fluidtopics.net/nFRtOM5SII_mAiDToi6ZSQ "Build an application to compile its source code and deployinstall application changes across an instance from the ServiceNow IDE.").

## Resultado

The converted application is added to your workspace with the necessary files and directories to support development in source code. 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.
Nota:  
For the ServiceNow IDE to install the required dependencies in an application, the public npm registry must respond with the HTTP `Access-Control-Allow-Origin` header.

* For the ServiceNow IDE to install the required dependencies in an application, the public npm registry must respond with the HTTP `Access-Control-Allow-Origin` header.
* If you encounter other issues after converting an application, you can run the <kbd class="ph userinput">Fluent: Reset Application</kbd><kbd class="ph userinput">Synchrotron: Reset Application</kbd> command to remove source files in the application (not application metadata) and re-convert the application.
{#convert-application-servicenow-ide__ul_rbd_flp_nfc}

## O que Fazer Depois

From your Git provider, create a dedicated Git repository for the application. Initialize a local Git repository for your application and push it to the remote repository. For more information, see [Initialize a Git repository with the ServiceNow IDE](https://servicenow-prod.fluidtopics.net/KWWsREx4zfkOkiIb7J~sLw "Initialize a local Git repository for an application and push it to a remote Git repository to manage an application in source control.").

In the ServiceNow IDE, start developing your application in source code with ServiceNow Fluent, writing custom JavaScript modules, or adding third-party libraries.