Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including ntypescript with all npm packages installed. Try it out:

var ntypescript = require("ntypescript")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

ntypescript v1.201706190042.1

A nicer version of microsoft/typescript packaged and released for API developers

NTypeScript is dead. Bring your own TypeScript 🌹

The following is left as legacy docs.


Downloads BuildStatus

Nicer TypeScript, making it easier to work with the compiler API 🌹


Kudos to the TypeScript team for maintaining all the code that this project depends on. This project is just a minor automation on top.

Niceness list:

  • Releases everyday.
  • Consistent side by side usage (just add an n prefix): require('ntypescript'), ntsc
  • package.json links you to typescript definitions (using typescript.definition entry)
  • Super Nice: We expose the internal APIs (the ones that have /* internal */)
  • Super Nice: We expose the global ts variable. Just require('ntypescript') once and start using ts like you are in the actual compiler source code.
  • Super Nice: Converts const enum in the compiler definition to enum. This decreases the typescript compiler version dependence on your dev tools TS->JS emit.
  • Easier to muck around with the compiler / language service when installed from NPM. Just open any file from node_modules/ntypescript/src folder in atom-typescript and press f6 to get a new local rebuild.

Design incompatibilities:

  • This project does not ship with tsserver.


Similar to typescript you can install and use ntypescript globally:

npm install ntypescript -g

or in your package.json

npm install ntypescript@latest --save --save-exact

Each release is named after the day it was built and the git commit hash in Microsoft/TypeScript/master that it was built from. We recommend adding save-exact as there are no guarantees on when stuff might break and you want your users to get the same version you tested.



You can use ntsc exactly like the tsc command line tool.


Use require('ntypescript')

Global ts

In addition to returning what typescript returns we also expose ts as a global.

declare var require: any;

Which makes it easy to use the compiler API if you are using it heavily. Note you only need to require once from any file.

Replace TypeScript

For require('typescript') you can do that quite simply using your package.json:

"dependencies": {
    "typescript": "<release name>"

Release name example : 1.201506301047.1+e1c9d28cb0706f81c14ca95b92fa3e2a223cc60b


This project comes with a built in grunt task called ntypescript. Just has just one task level option:

  • project : path to the project directory i.e. the directory that contains tsconfig.json.

Here is a sample Gruntfile.js for usage:

module.exports = function(grunt) {

        ntypescript: {
            options: {
                project: '.'

    grunt.registerTask('default', ['ntypescript']);

NPM Scripts

Init and setup in package.json

npm init
npm install ntypescript@latest --save --save-exact
"scripts": {
    "build": "ntsc -p ./src"

And then you just need to do the following to build your project:

npm run build


Note that this is a personal endeavor, not officially by Microsoft.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free