Skip to content

Just a boilerplate for a Typescript/Node project with yarn, linting, github-ready documentation and mocha+chai tests

Notifications You must be signed in to change notification settings

alexewerlof/typescript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Introduction

About a year ago I wrote about when to use TypeScript. Today I'm releasing a boilerplate for Node applications. The main use case is a library that is going to be published as a NPM module with documentation on github.

This is a typescript boilerplate project that supports:

  • visual studio code + node debugging in IDE
  • tslint
  • mocha / chai tests
  • jsdoc and HTML document generation
  • Clean JS output that's ready to use in Node projects (using tslib)
  • TS type definition files that's ready to use in TS projects
  • Pre-commit task to keep the documents up to date

How to use

git clone [email protected]:userpixel/typescript.git

Or just Download it.

Then modify the files as you wish.

Prerequisites

  1. Get VSCode.
  2. Make sure you have Node (and NPM)
  3. Install TSLint
  4. Open the code dir and make sure to install the dependencies (yarn on command line or F1 > "Run Task" > "install" in VSCode).

In VSCode

Every time you wanna run it just press Ctrl+Shift+B to build. To run tests, press F1 > "Run Task" > "test".

What is where?

  • src/ Write your TypeScript files here. It can have sub directories if you want. Each file has its own test next to it named FILENAME.spec.ts or FILENAME.test.ts.
  • .vscode Your Visual Studio Code configurations. You can tweak them if you want but the main part is the tasks.json which defines the compile build task as well as test and document.

Auto generated dirs

The following directories are auto generated and shouldn't be changed manually:

  • build/ the Javascript version of the TypeScript files. They contain documentation and are cleanly compiled so they are readable.
  • docs HTML version if your JSDoc annotations from the code
  • test Javascript test files (all files named FILENAME.spec.ts and FILENAME.tests.ts end up here after compilation)
  • tsdecl TypeScript declaration files that can be used when you release this module as a library and your user wants to use it their in TypeScript projects.

License

It's MIT so you can use the code for proprietary projects or extend it without contributing back.

Contributing

Remember the use case of this project. It's not going to be used for React and front end code. Just node and ideally a published lib to npm (and github).

  1. Discuss issues and ideas at https://github.com/userpixel/typescript/issues
  2. Make PRs

About

Just a boilerplate for a Typescript/Node project with yarn, linting, github-ready documentation and mocha+chai tests

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published