@zettelooo/extension-build-tools v2.0.1
Zettel: Extension build helper tools
Build and helper tools for extension development.
Installation
$ npm install --save-dev @zettelooo/extension-build-tools
Usage
This package provides shell command zettel-ebt
executable binary.
You can use it to speed up a couple of tasks while developing Zettel extensions.
See help:
$ zettel-ebt --help # / -h
Version extension's manifest:
$ zettel-ebt version patch # / minor / major
Pack and zip extension's files:
$ zettel-ebt pack
Upload the extension's zipped file:
$ ZETTEL_TARGET_ENVIRONMENT=live ZETTEL_DEVELOPER_ACCESS_KEY=??? zettel-ebt upload
Configuration
You may provide the following configuration parameters either as the CLI command flags or options in the config file; which is either .zettelebtrc
, .zettelebtrc.json
, .zettelebtrc.js
, .zettelebtrc.yml
, or .zettelebtrc.yaml
.
RC file property path | Command-line flag | Default | Description |
---|---|---|---|
paths.root | -r , --root-path | "." | Project root relative path, contains package.json file |
paths.public | -p , --public-path | "public" | Public folder relative path to root, contains manifest.jsonc file |
paths.src | -s , --src-path | "src" | Source folder relative path to root, contains index.js file |
paths.out | -o , --out-path | "out" | Dist folder relative path to root, to place the packed content |
Development
Clone the repository locally:
$ git clone git@github.com:zettelooo/extension-build-tools.git
Install the dependencies:
$ cd extension-build-tools
$ npm install
It's recommended to use VS Code to develop this project. You need to have Prettier extension to be installed on your IDE.
Publication
Publish a new version of the NPM package:
- Push all the changes. The workspace needs to be cleaned.
- Make sure you're on
master
branch.
$ npm version patch # / minor / major / any other valid semantic version
Misc
You can use the following NPM script to access Zettel Build Tools:
$ npm run bt -- <command> # e.g.: npm run bt - update
Copyright: Zettel, 2020-23