Installing and Using TypeScript on a Windows Machine

Installing and Using TypeScript on a Windows Machine


TypeScript, a superset of JavaScript developed by Microsoft, adds static typing and some other features to the language, making it a great choice for large-scale or complex JavaScript projects.

This article provides a comprehensive guide on installing and using TypeScript on a Windows machine.


Node.js: TypeScript is installed via npm (Node Package Manager), which comes with Node.js. Ensure you have Node.js installed on your machine. If not, download and install it from

Installing TypeScript

TypeScript can be installed globally on your machine or locally in your project. It’s generally recommended to install it locally for each project to avoid version conflicts between different projects.

Global Installation:

Open the Windows Command Prompt or PowerShell and run the following command:

npm install -g typescript

This installs TypeScript globally, making the TypeScript compiler (tsc) available from any directory in your command line.

Local Installation:

Navigate to your project’s root directory in the command line and run:

npm init -y 

This initialises your project with a package.json file if you haven’t already npm install --save-dev typescript

This installs TypeScript as a development dependency in your project.

Compiling TypeScript to JavaScript

Once TypeScript is installed, you can start using it to compile .ts files to .js.

Create a TypeScript File:

Create a new file with the .ts extension, for example, app.ts, and write some TypeScript code.

Compile TypeScript File:

If TypeScript is installed globally, run:

tsc app.ts

If installed locally, use the script in your package.json or run:

npx tsc app.ts

This compiles app.ts to app.js, which can be run in any JavaScript environment.

Configuring TypeScript (Optional)

For larger projects, you’ll want to configure TypeScript options. This is done using a tsconfig.json file.

Create a tsconfig.json File:

  • Globally: Run tsc --init in your project root.
  • Locally: Add a script in your package.json like "tsc:init": "tsc --init" and then run npm run tsc:init.

Configure Your Project: Edit the tsconfig.json to specify your compiler options like the target JavaScript version, modules, source maps, the root directory, out directory, etc.

Using TypeScript with an IDE

Most modern IDEs like Visual Studio Code support TypeScript out of the box. They provide features like syntax highlighting, error reporting, and IntelliSense, which greatly enhance the development experience.

  1. Install an IDE: If you haven’t, install an IDE such as Visual Studio Code.
  2. Open Your Project: Open your TypeScript project in the IDE.
  3. Start Coding: The IDE should automatically recognize .ts files and provide TypeScript support.


TypeScript is a powerful tool that extends the capabilities of JavaScript, and setting it up on a Windows machine is straightforward. By following these steps, you can easily install TypeScript, compile .ts files to .js, configure your TypeScript project, and enjoy the benefits of TypeScript with an IDE.

Whether you’re working on a small script or a large-scale application, TypeScript can significantly enhance your JavaScript development experience.


Hi, my name is Stephen Finchett. I have been a software engineer for over 30 years and worked on complex, business critical, multi-user systems for all of my career. For the last 15 years, I have been concentrating on web based solutions using the Microsoft Stack including ASP.Net, C#, TypeScript, SQL Server and running everything at scale within Kubernetes.