Tutorial: Create an ASP.NET Core app with TypeScript in Visual Studio

Applies to: Visual Studio Visual Studio for Mac Visual Studio Code

In this tutorial for Visual Studio development using ASP.NET Core and TypeScript, you create a simple web application, add some TypeScript code, and then run the app.

Starting in Visual Studio 2022, if you want to use Angular or Vue with ASP.NET Core, it is recommended that you use the ASP.NET Core Single Page Application (SPA) templates to create an ASP.NET Core app with TypeScript. For more information, see the Visual Studio tutorials for Angular or Vue.

In this tutorial, you learn how to:

• Create an ASP.NET Core project
• Add the NuGet package for TypeScript support
• Add some TypeScript code
• Run the app
• Add a third-party library using npm

Prerequisites

• You must have Visual Studio installed and the ASP.NET web development workload.

  If you haven't already installed Visual Studio 2022, go to the Visual Studio downloads page to install it for free.

  If you need to install the workload but already have Visual Studio, go to Tools > Get Tools and Features..., which opens the Visual Studio Installer. Choose the ASP.NET and web development workload, then choose Modify.

Create a new ASP.NET Core MVC project

Visual Studio manages files for a single application in a project. The project includes source code, resources, and configuration files.

Note

To start with an empty ASP.NET Core project and add a TypeScript frontend, see ASP.NET Core with TypeScript instead.

In this tutorial, you begin with a simple project containing code for an ASP.NET Core MVC app.

1. Open Visual Studio.

2. Create a new project.

   In Visual Studio 2022, choose Create a new project in the start window. If the start window is not open, choose File > Start Window. Type web app, choose C# as the language, then choose ASP.NET Core Web App (Model-View-Controller), and then choose Next. On the next screen, name the project, and then choose Next.

   Choose either the recommended target framework or .NET 6, and then choose Create.

   If you don't see the ASP.NET Core Web App project template, you must add the ASP.NET and web development workload. For detailed instructions, see the Prerequisites.

   Visual Studio creates the new solution and opens your project in the right pane.

Add some code

1. In Solution Explorer (right pane). right-click the project node and choose Manage NuGet Packages. In the Browse tab, search for Microsoft.TypeScript.MSBuild, and then click Install on the right to install the package.

   

   Visual Studio adds the NuGet package under the Dependencies node in Solution Explorer.

2. Right-click the project node and choose Add > New Item. Choose the TypeScript JSON Configuration File, and then click Add.

   If you don't see all the item templates, choose Show All Templates, and then choose the item template.

   Visual Studio adds the tsconfig.json file to the project root. You can use this file to configure options for the TypeScript compiler.

3. Open tsconfig.json and replace the default code with the following code:

   {
     "compileOnSave": true,
     "compilerOptions": {
       "noImplicitAny": false,
       "noEmitOnError": true,
       "removeComments": false,
       "sourceMap": true,
       "target": "es5",
       "outDir": "wwwroot/js"
     },
     "include": [
       "scripts/**/*"
     ]
   }
   

   The outDir option specifies the output folder for the plain JavaScript files that are transpiled by the TypeScript compiler.

   This configuration provides a basic introduction to using TypeScript. In other scenarios, for example when using gulp or webpack, you may want a different intermediate location for the transpiled JavaScript files, depending on your tools and configuration preferences, instead of wwwroot/js.

4. In Solution Explorer, right-click the project node and choose Add > New Folder. Use the name scripts for the new folder.

5. Right-click the scripts folder and choose Add > New Item. Choose the TypeScript File, type the name app.ts for the filename, and then click Add.

   If you don't see all the item templates, choose Show All Templates, and then choose the item template.

   Visual Studio adds app.ts to the scripts folder.

6. Open app.ts and add the following TypeScript code.

   function TSButton() {
      let name: string = "Fred";
      document.getElementById("ts-example").innerHTML = greeter(user);
   }
   
   class Student {
      fullName: string;
      constructor(public firstName: string, public middleInitial: string, public lastName: string) {
          this.fullName = firstName + " " + middleInitial + " " + lastName;
      }
   }
   
   interface Person {
      firstName: string;
      lastName: string;
   }
   
   function greeter(person: Person) {
      return "Hello, " + person.firstName + " " + person.lastName;
   }
   
   let user = new Student("Fred", "M.", "Smith");
   

   Visual Studio provides IntelliSense support for your TypeScript code.

   To test this, remove .lastName from the greeter function, then retype the ".", and you see IntelliSense.

   

   Select lastName to add the last name back to the code.

7. Open the Views/Home folder, and then open Index.cshtml.

8. Add the following HTML code to the end of the file.

   <div id="ts-example">
       <br />
       <button type="button" class="btn btn-primary btn-md" onclick="TSButton()">
           Click Me
       </button>
   </div>
   

9. Open the Views/Shared folder, and then open _Layout.cshtml.

10. Add the following script reference before the call to @RenderSectionAsync("Scripts", required: false):

    <script src="~/js/app.js"></script>
    

Build the application

1. Choose Build > Build Solution.

   Although the app builds automatically when you run it, we want to take a look at something that happens during the build process.

2. Open the wwwroot/js folder, and you find two new files, app.js and the source map file, app.js.map. These files are generated by the TypeScript compiler.

   Source map files are required for debugging.

Run the application

1. Press F5 (Debug > Start Debugging) to run the application.

   The app opens in a browser.

   In the browser window, you will see the Welcome heading and the Click Me button.

   

2. Click the button to display the message we specified in the TypeScript file.

Debug the application

1. Set a breakpoint in the greeter function in app.ts by clicking in the left margin in the code editor.

   

2. Press F5 to run the application.

   You may need to respond to a message to enable script debugging.

   Note

   Chrome or Edge is required for client-side script debugging.

3. When the page loads, press Click Me.

   The application pauses at the breakpoint. Now, you can inspect variables and use debugger features.

Add TypeScript support for a third-party library

1. Follow instructions in npm package management to add a package.json file to your project. This adds npm support to your project.

   Note

   For ASP.NET Core projects, you can also use Library Manager or yarn instead of npm to install client-side JavaScript and CSS files.

2. In this example, add a TypeScript definition file for jQuery to your project. Include the following in your package.json file.

   "devDependencies": {
      "@types/jquery": "3.5.1"
   }
   

   This adds TypeScript support for jQuery. The jQuery library itself is already included in the MVC project template (look under wwwroot/lib in Solution Explorer). If you are using a different template, you may need to include the jquery npm package as well.

3. If the package in Solution Explorer is not installed, right-click the npm node and choose Restore Packages.

   Note

   In some scenarios, Solution Explorer may indicate that an npm package is out of sync with package.json due to a known issue described here. For example, the package may appear as not installed when it is installed. In most cases, you can update Solution Explorer by deleting package.json, restarting Visual Studio, and re-adding the package.json file as described earlier in this article.

4. In Solution Explorer, right-click the scripts folder and choose Add > New Item.

   If you don't see all the item templates, choose Show All Templates, and then choose the item template.

5. Choose TypeScript File, type library.ts, and choose Add.

6. In library.ts, add the following code.

   var jqtest = {
      showMsg: function (): void {
         let v: any = jQuery.fn.jquery.toString();
         let content: any = $("#ts-example-2")[0].innerHTML;
         alert(content.toString() + " " + v + "!!");
         $("#ts-example-2")[0].innerHTML = content + " " + v + "!!";
      }
   };
   
   jqtest.showMsg();
   

   For simplicity, this code displays a message using jQuery and an alert.

   With TypeScript type definitions for jQuery added, you get IntelliSense support on jQuery objects when you type a "." following a jQuery object, as shown here.

   

7. In _Layout.cshtml, update the script references to include library.js.

   <script src="~/js/app.js"></script>
   <script src="~/js/library.js"></script>
   

8. In Index.cshtml, add the following HTML to the end of the file.

   <div>
      <p id="ts-example-2">jQuery version is:</p>
   </div>
   

9. Press F5 (Debug > Start Debugging) to run the application.

   The app opens in the browser.

   Click OK in the alert to see the page updated to jQuery version is: 3.3.1!!.

   

Next steps

You may want to learn more details about using TypeScript with ASP.NET Core. If you are interested in Angular programming in Visual Studio, you can use the Angular language service extension for Visual Studio.

ASP.NET Core and TypeScript

Angular language service extension