Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/boilertown/node-cli-boilerplate
The boilerplate with opinionated setup to help you quickly kickstart your Node.js CLI app.
https://github.com/boilertown/node-cli-boilerplate
cli eslint nodejs prettier tsup typescript
Last synced: 3 months ago
JSON representation
The boilerplate with opinionated setup to help you quickly kickstart your Node.js CLI app.
- Host: GitHub
- URL: https://github.com/boilertown/node-cli-boilerplate
- Owner: boilertown
- License: mit
- Created: 2022-08-16T03:06:38.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-01T09:59:40.000Z (over 1 year ago)
- Last Synced: 2024-07-06T22:11:51.212Z (4 months ago)
- Topics: cli, eslint, nodejs, prettier, tsup, typescript
- Language: TypeScript
- Homepage:
- Size: 682 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
♨️ Node CLI Boilerplate
A Node.js boilerplate with opinionated setup to help you kickstart your own CLI.
## The Setup
- [TypeScript][typescript-url]
- Linting with [Eslint][eslint-url] and code formatting with [Prettier][prettier-url]
- Conventional commit messages with [Commitlint][commitlint-url]
- Build with [tsup][tsup-url]
- [Vitest][vitest-url] for Unit test
- Automated release with [changesets][changesets-url]
## Get Started
- Use [Boilertown](https://github.com/boilertown/create-boilertown) CLI.
```sh
# npm
npm create boilertown@latest -- -b node-cli-boilerplate
# yarn
yarn create boilertown -b node-cli-boilerplate
# pnpm
pnpm create boilertown -b node-cli-boilerplate
# bun
bun create boilertown/node-cli-boilerplate [cli-name]
```
- Click the green "Use this template" button to generate a new repository with the same structure and files.
[Ref: Github Docs](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)
## Development
- Run the app in development mode:
```sh
pnpm dev
```
- Build the app:
```sh
pnpm build
```
- Create changeset:
```sh
pnpm changeset
```
## Release & Publish app
This boilerplate uses [changesets][changesets-url] to automatically generate `CHANGELOG`, create releases and publish to NPM registry via GitHub Actions. You can see action details at [release.yml](/.github/workflows//release.yml).
To automating publish your app, follow these steps:
- Create a `NPM_TOKEN`. [See this article for more details](https://docs.npmjs.com/creating-and-viewing-access-tokens). Make sure the type of access token is **Automation**.
- [Follow this instruction](https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository) to add the created token to your GitHub Actions secrets. Name of the secret is `NPM_TOKEN`.
- Install [changeset bot](https://github.com/apps/changeset-bot).
- [Adding changeset and commit](https://github.com/changesets/changesets/blob/main/docs/adding-a-changeset.md#i-am-in-a-single-package-repository).
**P/S**: Remember to check the `Allow GitHub Actions to create and approve pull requests` in your repo Settings > Actions > General & scroll to Workflow permissions.
## Contributing
**node-cli-boilerplate** ❤️ your contributions. If you have any ideas, suggestions, fixes, feel free to contribute.
[boilertown-url]: https://github.com/boilertown
[typescript-url]: https://www.typescriptlang.org
[eslint-url]: https://eslint.org
[commitlint-url]: https://github.com/conventional-changelog/commitlint
[prettier-url]: https://prettier.io
[changesets-url]: https://github.com/changesets/changesets
[tsup-url]: https://tsup.egoist.sh
[vitest-url]: https://vitest.dev