@stencila/typescript-boilerplate v1.1.173
@stencila/typescript-boilerplate
What
An opinionated tooling setup for Typescript projects including,
typescript
for compiling Typescriptjest
for testingtypedoc
for source code documentationts-node
andts-node-dev
for running scripts during development
Usage
Just use this as an example when creating a new project. Check out the package.json
and add
or modify other files as needed...
A tsconfig.json
file that extends
or modifies the Typescript configuration in dev-config
e.g.
{
"extends": "@stencila/dev-config/tsconfig.json",
"compilerOptions": {
/* Enable experimental support for ES7 decorators. */
"experimentalDecorators": true
}
}
Add a jest
configuration object to your package.json
:
// …
"jest": {
"preset": "ts-jest",
"testEnvironment": "node",
"testMatch": [
"**/tests/**/*.test.ts"
]
},
// …
Create a typedoc.json
file or modify the one in dev-config
{
"out": "./docs",
"readme": "./README.md"
}
Add scripts
to your package.json
file for running tests, collecting coverage, building the package and generating documetation:
// …
"scripts": {
"test": "jest",
"test:cover": "jest --collectCoverage",
"test:watch": "jest --watch",
"build": "tsc",
"docs": "typedoc src"
},
// …
- Add
main
,types
and other entries in yourpackage.json
file to point to the compiled files in thedist
folder:
// …
"main": "dist/src/index.js",
"types": "dist/src/index.d.ts",
"bin": "dist/src/cli.js",
// …
- Add the following folders to your
.gitignore
file:
/coverage
/dist
/docs
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago