Repository navigation
Build and Upload
Every release is a new version of your Layout on Selldone. scripts/release.sh runs every step in order; this page explains each one.
npm i -g selldone-cli # the official CLI
git clone https://github.com/selldone/cli selldone-cli-src # its packager lives in .agents/Sign in to the CLI once:
- Run
selldone. - Choose Login | Login to your Selldone account.
- Approve the sign-in in your browser and type your 2FA code in the terminal.
selldone login is not a command. The sign-in is saved in ~/.selldone-dev/.persist; if that file is empty, every upload answers 401 until you sign in again.
The first upload creates your Layout. Leave LAYOUT_ID out:
SELLDONE_CLI_SRC=../selldone-cli-src bash scripts/release.sh 1.0.0 deskNote the Layout id printed after it (it is also in the Selldone developer panel). Every later release:
LAYOUT_ID=<your Layout id> SELLDONE_CLI_SRC=../selldone-cli-src \
bash scripts/release.sh <new version> deskThe arguments:
- the new version, never used before;
- the account design:
desk(side rail, the one Argon ships) orhome(tabs).
With LAYOUT_ID set, the script also checks the upload on the server. Argon's own Layout id on the showcase shop: see ARGON.md.
| Step | Why |
|---|---|
Bump version in manifest.json
|
A version number is used up even when an upload fails. Never reuse one. |
npm run build-production |
Outputs dist/app/shop.js, shop.css and chunks with a relative base. Releases are served from cdn.selldone.com/public/layouts/<id>/releases/<ULID>/app/. The photos in assets/photos/ and assets/argon/ are picked up here. |
rm dist/index.html |
Every ZIP member must be under app/. In production the Layout runs inside Selldone's HTML, so index.html is never used. Fonts load from the app code. |
scripts/kalio-svg-flatten.mjs |
Selldone accepts only passive SVG attributes. style, <style>, xml:space, enable-background, display, fx/fy, data-* and character references in values are refused. |
MIME check (file --mime-type) |
Selldone stores the MIME type it sniffs. A chunk starting with import{ is stored as text/x-java, which browsers refuse. Every chunk starts with "use strict"; (sniffAsJavaScript in vite.config.ts). |
No ../shop.js imports |
Selldone's loader reaches shop.js through a redirect. A chunk importing ../shop.js loads the app twice: an old page flashes, then the page goes blank. Shared code lives in a core chunk. |
| File count under ~360 | The archive is extracted inside the upload request, behind a ~100 s limit. At 714 files it was cut off mid-way and the version was burned. |
package_layout.py … --force |
Without --force, an old dist.zip is kept and it still prints PASS. |
cmp of shop.js
|
Proves the ZIP is this build. |
scripts/kalio-deploy.mjs |
Uploads with the official CLI's sign-in and checks, sending the manifest in the form the server accepts. |
scripts/kalio-verify-deploy.mjs |
Asks the server: the newest deploy must show extracting:false, error:null, js_match:true and css_match:true. A CLI exit code is not proof.
|
-
manifestholds onlypackage, version, name, description, storefront, backoffice. - No spaces or brackets in any file name (
safeNameinvite.config.ts). - The
packagename never changes after the first upload. - An upload creates a beta version. Your shop doesn't change until you attach it: see Go Live.
node --use-system-ca scripts/kalio-live-preview.mjs <release-ULID> 9125This serves your shop's real HTML with the loader pointed at that release. The ULID is in the deploy path that kalio-verify-deploy.mjs prints.