Themes

A theme is a repository with a theme.json, a pb_public overlay (files copied over an instance's static files) and the SCSS or CSS a stack app imports. The marketplace audits what those files are, hashes each one and serves them under /registry/v1/themes/, beside the plugins and the templates.

You copy a theme, you do not install it. voidbase plugins add installs plugins, and there is no voidbase themes add in the package yet. The version record lists every file it carries with its size and its hash, and each one is served at /registry/v1/themes/<name>/<version>/<path>, so this fetches exactly the bytes that were audited:

base=https://marketplace.voidbase.cloud/registry/v1/themes/<name>/<version>
curl -fsS "$base.json" | jq -r '.files[].path' | while read -r p; do
  mkdir -p "$(dirname "$p")" && curl -fsS "$base/$p" -o "$p"
done

That writes the theme's own layout into the current directory. Copy its overlay over your pb_public/, and import its stylesheet from your app. Nothing is pinned and nothing is verified for you afterwards: the hashes are in the record, and checking them is yours to do until the package has a command that does it.