A starter repo for creating libraries for browsers using TypeScript and Rollup.

To start, click the Use Template button on Github (or download the zip file and run git init). Then clone the repo and install dependencies with npm install.

To create a new library, change the name, description, author, copyright notice, license and other properties in package.json, LICENSE and README.

Create source files in src and export them in index.ts.

To test the library, make tests/examples in examples and include them in index.html. Examples should access the builds from ../dist and not the source files from the src directory.

To use the library locally, make a new project and include it in the package.json dependencies using file:./../../path/to/this/repo.

When pushing to Github on the master or main branch, the docs will be build using Github actions and pushed to Github pages. For this, Github pages must be enabled in the Github repository settings.

Build for development (Build and watch):

npm run dev

To serve the local build and examples, run

npm run serve

Build for production (Build):

npm run build

Build docs

npm run docs

View docs locally

npm run serve-docs

Publish to npm

npm run new:publish

Generate a packed .tgz

npm run new:pack

Generate a new version

npm version

MIT

Generated with rollup-library-starter