Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

MorningSpace Lab



The Path to TypeScript

Keywords: TypeScript


This is the lab project to demonstrate how to migrate a JavaScript project into TypeScript project step by step.

The project TaskMe is a very simple task management API service built by LoopBack. It was originally written in JavaScript. To "tsify" it, there are a few branches from tsify-original to tsify-misc, where each branch represents a certain stage on the migration path. By hitting the GitHub Compare changes view, you can see the difference between each two branches.

Please check the below instructions to learn how to play with it.

You can also find the online slides here, where it discussed:

  • Why TypeScript is so popular?
  • What is TypeScript? (by a few demos)
  • How to tsify?

And the video series recorded for the slides.

For more lab projects from MorningSpace Lab, please check


Branch: tsify-original

The very beginning stage. No TypeScript at all.

Branch: tsify-basic-use

This is the basic use of TypeScript. You can start to write TypeScript without changing any of your existing code. By adding type declaration files of project dependencies, you can enjoy auto-completion and code navigation when you call your dependencies. You can also get early benefits by trying to enable a few options in tsconfig.json, e.g. noImplicitReturns, noFallthroughCasesInSwitch, etc.

Branch: tsify-simple-trans

Start to transform some JavaScript src files into TypeScript src files w/o big effort. Just simple rename and probably some tweaks in tsconfig.json to avoid tsc complains.

Branch: tsify-deep-trans

Transform more JavaScript src files into TypeScript src files, add more TypeScript features incrementally, and use TypeScript more deeply. It normally requires some adjustments in the source code and tweaks in tsconfig.json.

Branch: tsify-misc

Complete migration to TypeScript project, add tslint for lint check, nyc for code coverage, debug settings in vscode for TypeScript debugging, etc.


Some typical errors can be seen as below when do the transformation.

Error TS2339: Property 'abc' does not exist on type 'xyz'.

The simplest resolution to this issue is to define the type 'xyz' as any. Of course you can define interface if it deserves. Keep in mind, whenever you use any, you lose out on most of the error checking and editor support that TypeScript gives you.

Error TS2451: Cannot redeclare block-scoped variable 'xyz'

This is caused by the use of let or var when require external module. Use ES6 syntax, the import statement instead.

Error TS2693: 'Promise' only refers to a type, but is being used as a value here

Add "es2015" in "lib" settings in tsconfig.json.

Error TS2307: Cannot find module 'your/path/to/something.json'

Since TypeScript 2.9, JSON file import has been well supported by enabling resolveJsonModule in tsconfig.json. See:

Error TS6133: 'err' is declared but its value is never read.



No description, website, or topics provided.



No releases published


No packages published