Theming
"Sharing: .velumtheme"
A .velumtheme is one file that holds a theme and everything a gallery or the theme picker shows for it. Double-click it, or drag it onto Studio, to install it.
Making one
In Theme Studio, Export .velumtheme… writes the bundle, with Theme Studio's preview of the theme and an icon made from it. Plain .json themes keep working beside bundles; a bundle adds what a single JSON file can't carry.
What's inside
A .velumtheme is a zip, in the Velum file container:
| File | What it is |
|---|---|
manifest.json |
What the file is, and the SHA-256 and size of every other file in it |
theme.json |
The same velum-theme/1 file as in your themes folder |
preview.png |
1280 × 800, Theme Studio's preview of the theme, for the gallery |
icon.png |
256 × 256, for the theme picker |
fonts/ |
Optional .ttf or .otf files; LICENSES/ is required with them |
images/ |
Optional .png or .jpg pictures the theme uses |
LICENSES/ |
.txt or .md license text for anything bundled |
signature.ed25519 |
Optional: a signature over the manifest |
Here is the manifest of Studio Dark, one of the two built-in themes, which ship as bundles read by the same code as yours:
{
"type": "velum.theme",
"format": 1,
"created": "2026-11-12T04:06:05.706578592Z",
"app": "0.1.0",
"name": "Studio Dark",
"description": "Velum Studio's built-in studio-dark theme",
"thumbnail": "preview.png",
"contents": [
{
"path": "theme.json",
"sha256": "7f75bd5651250010725f466eac124e5c3aaa93f8d97a3bfb3e707f41d3f4bee3",
"bytes": 2409
},
{
"path": "icon.png",
"sha256": "882dd7b5a0b5b6cd80b82afbab8d01d537c6017acefb76474ebe839922a4f42e",
"bytes": 7895
},
{
"path": "preview.png",
"sha256": "fcd775807ce71f150ef4f2bd5aba3bf5ace0ad997e48261288bec7a5ec3d3d60",
"bytes": 130656
}
]
}Rules
- A theme contains no code. Tokens, pictures and fonts only; any other file is refused.
- Every file is listed in the manifest with its SHA-256 and size, so a damaged or changed file is caught when it's opened, before anything in it is used.
- Size limits: at most 512 files, 20 MB unpacked in total, and 20 MB for any one file.
- Fonts a theme brings are used by Studio only and are never installed on the computer. They must come with a license that allows redistribution, in
LICENSES/.
Installing
Double-click a .velumtheme, or drag it onto Studio. It's unpacked into Studio's themes/<id>/ folder, and the version it replaces is kept so it can be rolled back. If Studio is already running, the file goes to that Studio rather than opening a second one.
Signing
A bundle can carry signature.ed25519, the same scheme every Velum file and plugin uses:
{"key": "<Ed25519 public key, 64 hex digits>", "signature": "<128 hex digits>"}The signature is Ed25519 over the exact bytes of manifest.json. Because the manifest holds the SHA-256 of every other file, one signature covers the whole bundle. Studio shows whether a file is unsigned, signed by its maker, or signed by the publisher, which is how themes listed in the public gallery will be marked. A signature that's present but doesn't verify makes Studio refuse the file.

