🎉 how-to-open-source 🎉
This module is meant as a learning/training tool for those interested in publishing their own open source project to the NPM Registry. It is also here for those wishing to learn how to contribute to open source projects. It is purely a learning and training tool at this point and holds no real purpose as a dependency to any production based application.
📓 Documentation 📓
Documentation is still present in the wiki, but is under construction 💯
There are currently no dependencies needed to run this package, although that can change with additional features so stay tuned!
$ npm install --save how-to-open-source## or$ yarn add how-to-open-source
const rcjh = rcjh;const result = ;console; // 'ROCK CHALK JAYHAWK, KU!'
;const result = ;console; // 'ROCK CHALK JAYHAWK, KU!'
Scripts in the
yarn build# prebuild git-hook will run first validating the code...# Executes rollup build of all distributions in production modeyarn commit# precommit git-hook will run first executing scripts# in lint-staged & validating the code...# Executes the commitizen-cliyarn prettier# Executes formating of code base defined by prettier.js.yarn start# Executes nps command.# used in .travis.yml to pass prefix to scripts# i.e. yarn start test --> nps testyarn test# Executes testing via jest & .jestConfig# generates coverage data.
🏃 Running code locally
If you are developing a cool new feature and want to see that it really does perform the way you want; follow these instructions to package the code base and run it just like you would if it was on the npm registry!
yarn build && yarn start library# Executes bundling in production environment.# Executes npm pack & opens the tarball file.# In sandbox files import your featureyarn start sandbox# Executes cjs & es code in corresponding sandbox.js files.
Please visit CONTRIBUTING.md