> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Microsoft/typescript/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation
> Install TypeScript using npm, yarn, pnpm, or bun
TypeScript is a language for application-scale JavaScript development. It adds optional types to JavaScript that support tools for large-scale applications for any browser, host, or OS.
## Requirements
TypeScript requires Node.js version **14.17 or higher** to run. Check your Node.js version:
```bash theme={null}
node --version
```
If you need to upgrade Node.js, visit [nodejs.org](https://nodejs.org/).
## Install TypeScript
Install TypeScript globally or as a dev dependency in your project:
```bash npm theme={null}
npm install -D typescript
```
```bash yarn theme={null}
yarn add -D typescript
```
```bash pnpm theme={null}
pnpm add -D typescript
```
```bash bun theme={null}
bun add -D typescript
```
Installing as a dev dependency (`-D` flag) is recommended for project-specific TypeScript versions. For global installation, use `npm install -g typescript`.
Confirm TypeScript is installed correctly:
```bash theme={null}
npx tsc --version
```
You should see output like:
```
Version 6.0.0
```
## Nightly Builds
Get the latest features and bug fixes by installing nightly builds:
```bash npm theme={null}
npm install -D typescript@next
```
```bash yarn theme={null}
yarn add -D typescript@next
```
```bash pnpm theme={null}
pnpm add -D typescript@next
```
```bash bun theme={null}
bun add -D typescript@next
```
Nightly builds contain experimental features and may be unstable. Use them for testing new features, not production environments.
## What Gets Installed
When you install TypeScript, you get two main command-line tools:
The TypeScript compiler that transforms `.ts` files into JavaScript
The TypeScript language server for editor support and tooling
Both tools are available in the `bin/` directory of the installed package:
* `bin/tsc` - TypeScript compiler
* `bin/tsserver` - Language server for IDE integration
## Global Installation
For system-wide access to TypeScript commands:
```bash theme={null}
npm install -g typescript
```
After global installation, you can use `tsc` directly without `npx`:
```bash theme={null}
tsc --version
tsc myfile.ts
```
Project-local installations (dev dependencies) are preferred over global installations to ensure consistent TypeScript versions across team members and CI/CD environments.
## Updating TypeScript
Keep TypeScript up to date to get the latest language features and improvements:
```bash npm theme={null}
npm update typescript
```
```bash yarn theme={null}
yarn upgrade typescript
```
```bash pnpm theme={null}
pnpm update typescript
```
```bash bun theme={null}
bun update typescript
```
To upgrade to a specific version:
```bash theme={null}
npm install -D typescript@6.0.0
```
## Troubleshooting
### Command not found
If `tsc` is not recognized after installation:
1. **Use npx** for local installations:
```bash theme={null}
npx tsc --version
```
2. **Check PATH** for global installations:
```bash theme={null}
npm config get prefix
```
Ensure this directory is in your system PATH.
3. **Reinstall TypeScript**:
```bash theme={null}
npm uninstall typescript
npm install -D typescript
```
### Version mismatch
If different versions appear in global vs local installations:
```bash theme={null}
# Check local version
npx tsc --version
# Check global version
tsc --version
```
Always use `npx tsc` in projects to use the local version.
## Next Steps
Create your first TypeScript project
Configure compiler options