Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

soufantech/node-js-lib-boilerplate

Open more actions menu

Repository files navigation


@soufantech/node-js-lib-boilerplate

SouFan's JavaScript boilerplate for Node.js libraries


jest-image npm-image

Setup

  1. Make a shallow clone of this project in the desired folder, renaming it (replace <MY_LIB_NAME> in any of the examples below for your project's name):
  • Using SSH: git clone --depth 1 git@github.com:soufantech/node-js-lib-boilerplate.git <MY_LIB_NAME>.
  • Using HTTPS: git clone --depth 1 https://github.com/soufantech/node-js-lib-boilerplate.git <MY_LIB_NAME>.
  1. Step into the recently cloned project and erase the .git directory completely.
  2. Make the required and optional overrides as described further below.
  3. Create a new repository with git init and commit your files.

Required overrides:

You must...

  1. update author, repository, homepage, bugs, name and version fields in package.json.
  2. delete or replace demo files: rm src/index.ts src/simple-math.ts src/__tests__/simple-math.test.ts.
  3. rewrite this README.md (after reading it);

Optional overrides:

You might want to...

  • set the license field (default is UNLICENSED). You may also include a LICENSE file on the root folder.
  • set the publishConfig.accessto public if your package is not meant to be published as a private package.
  • set the private field to false in order to publish the package.
  • set the repository field.
  • remove the test command along with the jest dependency if your project is not meant to include automated tests.
  • run yarn upgrade --latest to generate a fresh yarn.lock and upgrade all dependencies listed in your package.json.
  • exclude the .npmrc file or modify it if you're not using a SouFan NPM registry token (typically SOUFAN_NPM_TOKEN)

In addition to package.json, you might also want to check...

  • the .npmignore file for the files that will be ignored on publishing.
  • the test runner options on the jest.config.js file.
  • the linter rules in the eslintrc.yml file.
  • the general editor configuration on the .editorconfig file.

Built with ❤︎ by SouFan

About

SouFan's JavaScript boilerplate for Node.js libraries

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.