typescript-example-package

Example package for Typescript/Javascript code reuse, includes all the components to publish a package.
Consists of testing, linting, building and deploying of the package.

$3

Use this repository as a template on the GitHub site and after creating the new project
replace the name typescript-example of the package to the desired one.
Also, the GitHub links should be updated to the new repository.

The repository name don't have to include the term package, it's just for the puropse of showing what is the intention of the example.

When setting up the continous integration two environment variables are necessary: NPM_TOKEN, GH_TOKEN.

$3

The package uses Typesript becuase the consumers get hints on how to use the library within the sourcecode.

$3

Jest does the testing as it's not only a testruner, but also includes assertions and a virtual DOM library.

``bash
npm run test # Single test run, suitable for continous integration
npm run test:watch # Reruns modified tests on modification, good for development
`

$3

Linting is done with ESlint and Prettier because TSlint is no longer maintained.

`bash
npm run lint # Checks for lint failures based on ESlint rules and Prettier config
npm run lint:fix # Fixes lint errors where possible
`

$3

Besides the basic Typescript transpilation, the project uses microbundle
to generate separate optimized files for UMD, module and Node bundles.

`bash
npm run bundle # Generates the optimized files into the dist directory
`

$3

Semantic release enables to generate automatic versions based on commit messages.
By default, the package releases as public, you can change it within package.json (publishConfig.access).

`bash
npm run release # Creates a release on Github and publishes to NPM
`

$3

To use the package, run the following command in your application folder.

`bash
npm install @emartech/typescript-example
``