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 [email protected]: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