@dappykit/my-library
v1.1.0
Published
Library for Node.js and the browser using Typescript template
Downloads
1
Readme
MyLibrary: A TypeScript + Jest + Webpack Template for Node.js and Browser Libraries
Welcome to MyLibrary, a ready-to-use TypeScript template for building libraries that can run in both Node.js and the browser. This project is bundled with Jest for testing and Webpack for building your library.
Table of Contents
Getting Started
To get started, clone this repository to your local machine and run npm ci
.
npx @dappykit/my-library my-new-lib
Project Structure
Here's a brief overview of the key files and directories in this template:
src/
: The source code of your library. The entry point of the library issrc/index.ts
.test/
: Contains the tests for your library..github/workflows/
: Contains configuration for GitHub Actions workflows..babelrc.js
: Configures Babel, a JavaScript compiler..eslintrc.json
: Configures ESLint, a tool for identifying and reporting on patterns in JavaScript.jest.config.js
: Configures Jest, a JavaScript testing framework.tsconfig.json
: Configures TypeScript for the project.webpack.config.ts
: Configures Webpack for bundling the library.
Available Scripts
This template includes the following scripts:
npm run prepublishOnly
: Cleans thedist
directory and compiles TypeScript files to JavaScript. It also prepares the library for both Node.js and browser environments.npm run test
: Runs the Jest test suite.npm run lint:check
: Lints the codebase using ESLint and checks for formatting issues with Prettier.npm run check:types
: Checks for TypeScript type errors.npm run compile:node
: Compiles the code for Node.js using Webpack.npm run compile:types
: Compiles the TypeScript declarations.npm run compile:browser
: Compiles the code for the browser using Webpack.
GitHub Actions
This template includes three GitHub Actions workflows:
tests.yaml
: Runs tests, checks for type errors, and lints the code whenever changes are pushed or a pull request is created.publish_npmjs.yaml
: Publishes the package to npm when a new release is created on GitHub. You'll need to add your npm token to your repository's secrets under the nameNPM_TOKEN
.release_github.yaml
: Creates a new release on GitHub whenever changes are pushed to themaster
branch. For this to work, you'll need to add a personal access token to your repository's secrets under the nameREPO_GHA_PAT
.
Customizing the Library
To make this library your own, you'll need to change the following:
- Update
name
,version
,description
, andauthor
inpackage.json
. - If you want your library to be available under a different name in the
window
object when used in a browser, update thelibrary
key in theoutput
object inwebpack.config.ts
. For example, if you want your library to be available asMyNewLib
, you would setlibrary: 'MyNewLib'
. - Write your library's code in the
src/
directory. You can organize your code in this directory any way you want. Don't forget to updatesrc/index.ts
if you add or remove files. - Write tests for your library's code in the
test/
directory. Jest is configured to read all files in this directory that match the pattern*.test.ts
.
This template should give you a strong starting point for building a library that can run in both Node.js and the browser. Happy coding!