---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 1. Create an application

# Tutorial part 1: Create an application in the ServiceNow IDE {#ariaid-title1}

* Release version: Yokohama
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Create an application that you can develop in source code in the ServiceNow IDE.

## Before you begin

Role required: admin

## About this task

In the ServiceNow IDE, you can develop scoped applications in source code using ServiceNow Fluent to define application metadata \[sys_metadata\]. You can also create JavaScript modules and use third-party libraries to organize and reuse code within scoped applications. For an
application to support development in source code, you must create a scoped application or convert an existing scoped application using the ServiceNow IDE or ServiceNow SDK. In this tutorial, you create a scoped application from the ServiceNow IDE.

## Procedure

1. Navigate to AllApp DevelopmentServiceNow IDE.  
   Before you can create an application, you must create a workspace in which you can add applications and navigate through them from one place.

   Workspaces are specific to a user, and you can create multiple workspaces to group different sets of applications. Applications can be added or removed from a workspace at any time. Workspaces in the ServiceNow IDE are based on workspaces in Visual Studio Code.
2. Create a workspace.
   1. Select Create a workspace.
   2. Enter a name for the workspace and press Enter.
   3. Enter a description for the workspace and press Enter.  
      The workspace becomes the active workspace but doesn't contain any applications yet.

      Tip:  
      To switch the active workspace, you can browse and select other workspaces from the ServiceNow IDE home page or from the command palette with the <kbd class="ph userinput">Workspaces: Browse Workspaces</kbd> command.
   {#tutorial-create-application-ide__substeps_g5w_xqd_h2c}
3. Create an application in the workspace.
   1. Select Create an app.
   2. Enter a name, such as <kbd class="ph userinput">Hello World</kbd>, and press Enter.
   3. Enter a description for the application and press Enter.
   4. Enter a scope, such as <kbd class="ph userinput">x_snc_hello_world</kbd>, and press Enter.  
      Important:  
      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/zD6mydX19AlNBFq1Ki3tFQ "The system adds a namespace identifier to the front of application artifacts such as tables, scripts, and configuration records.").
   5. Enter a package name, such as <kbd class="ph userinput">x-snc-hello-world</kbd>, and press Enter.  
      The package name must adhere to Node Package Manager (npm) package naming standards.
   6. Select the A basic application using NowSDK and TypeScript template to use TypeScript to create JavaScript modules.  
      The application templates define the default application structure.  
      Note:  
      TypeScript uses static typing and type annotations to support developers catching errors earlier while writing code. If you'd prefer to get started with JavaScript instead, select JavaScript.  
      Your application is added to your workspace. From the File Explorer view (![File Explorer]()), you can navigate through the application files.

      The package.json and now.config.json files define the application structure, which is similar to that of Node.js applications or Node Package Manager (npm) packages. A
      sample ServiceNow Fluent file (index.now.ts) and JavaScript module (script.js or script.ts) were created in the
      src directory, and dependencies were installed into the node_modules directory. The application is also added to the Custom Application \[sys_app\] table.

      Next, build and install the application to make it available for development across the instance.
   7. From the Status Bar at the bottom of the ServiceNow IDE, select Build and Install.  
      Building and installing the application compiles its ServiceNow Fluent code and JavaScript or TypeScript module code into Application Files \[sys_metadata\] and EcmaScript Modules \[sys_module\] on the instance, respectively. Build artifacts in
      the dist/app directory are packaged into an installable
      .zip file in the target directory.

      Logs in the Output panel indicate the status of the build and if the application is installed successfully. If either process fails, review the logs to identify any issues.

      For information about the application structure, see the [Application structure](https://servicenow-prod.fluidtopics.net/NZvoSqmUdToPQ43Dq2OslQ#building-applications-source-code__application-structure) section of the Building applications in source code topic.
   {#tutorial-create-application-ide__substeps_rnd_xrd_h2c}

## What to do next

Continue to [Tutorial part 2: Initialize a repository for your application](https://servicenow-prod.fluidtopics.net/ll9B8zi1o2sdj5BSlixh2A "Initialize a local Git repository for an application in the ServiceNow IDE and push it to a remote Git repository in GitHub to manage the application in source control.").

*[\>]: and then