@nextplus/addons-cli (npaddons)

A simple CLI to publish NextPlus Addons to the Addons Server.

Install

npm i -g @nextplus/addons-cli

Verify:

npaddons --help

Commands

• npaddons set-server <url>: Set the server base URL (defaults to https://addons.nextplus.io).
• npaddons set-token <token>: Set the authentication token used to talk to the server.
• npaddons publish <folder>: Publish the folder contents to the server using a presigned upload.

Usage

1. Set the token (you receive it out-of-band):

npaddons set-token YOUR_TOKEN_HERE

2. Optional: Override the server URL (default is https://addons.nextplus.io):

npaddons set-server https://addons-test.nextplus.io

3. Publish a folder (absolute or relative path):

npaddons publish ./build

During publish, the CLI will:

• Validate the folder size is ≤ 50 MB (sum of file sizes).
• Validate index.html exists at the root of the provided folder.
• Validate there is no node_modules directory at the folder root.
• Request a signed upload from the server and upload all files recursively, showing a progress bar.

Troubleshooting

• 401 Unauthorized: Ensure you ran npaddons set-token with a valid token.
• Invalid URL: Use http:// or https:// (e.g., npaddons set-server https://addons.nextplus.io).
• Validation errors: Ensure index.html exists, the total size ≤ 50MB, and no node_modules in the root.

Uninstall

npm uninstall -g @nextplus/addons-cli