Template for making easy-to-work-with tempates
- Copy this template
- Clone to a local directory (eg
git clone https://github.com/me/my-repository/ && cd my-repository
) - Run
./setup.js
to initialize the node package (Get rid of template strings - and this readme!) - Happy Coding!
yarn build
will build using typescript pre-configured to node-compatible defaultsyarn docs
will auto-generate a README.md that starts with TOP.md, then adds CLI documentation (via commanderdoc) for any tool you have set up, and then library documentation after that.yarn test
is pre-configured to test for typescript errors
git commit
will be blocked on themain
branch unless you set the environment variableALLOWMAIN=1
Branch commits and PRs are thus encouragedgit commit
also tests messages for meeting the commitline standard conventions.git commit
blocks pushes that do not passyarn test
(as a base case, they must pass typescript compilation)npm publish
will always rebuild the code, the documentation, and push those changes back to the repository.npm publish
will only publish the lib and src directories - any others are no
I made a deliberate choice to change the primary branch from master
to main
for reasons that are obvious to some. This repository endeavors to make that just automatic.
PRs and feedback welcome via GitHub issues.
npx template [options]