verso.json
verso.json marks a folder as a Verso site and holds its few settings. Everything about the look lives in Elevate’s files beside it.
Verso finds a site by looking for verso.json in the current folder or any folder above it. You can edit it by hand, but you don't have to: Site settings in the editor sets the name, address, sub-folder, language and search index, the Design panel's Text tab sets "rich", and Make a channel adds to "channels". A complete file looks like this:
{
"name": "Verso",
"locale": "en-US",
"url": "https://verso.example",
"base": "",
"index": true,
"channels": {
"changelog": { "label": "Changelog", "template": "release", "item": "release" }
},
"rich": {
"p": "mg-b:d5",
"h2": "font:display:h4:bold:tight text:ink:hug mg-t:d13 mg-b:d4",
"a": "text:ink:underline @hover:[text:proof-2]",
"code": "font:mono:code pd-x:d1 bg-color:code-bg bd:round-d1",
"pre code": "font:mono:code text:ink"
}
}
| Key | Default | What it does |
|---|---|---|
name | "My site" | The site’s name. Shown in the editor, added after each page’s title in its <title> (“About — Verso”) unless the title already has it, and used alone for a page without a title |
locale | "en-US" | How dates are written. {{ page.date }} on 2026-11-16 is “November 16, 2026” in en-US and “16 November 2026” in en-GB |
url | none | Where the live site is. When set, a build writes sitemap.xml and an RSS feed for each channel. A trailing slash is dropped |
base | none | The folder the site lives in on its host, like "/notes". The build puts it in front of every address that starts at the root. See Feeds and sub-folders |
index | false | When true, a build writes pages.json, every live page with its text, for search |
rich | {} | Elevate classes for each element rich text can contain |
channels | {} | Folders of posts, by folder: a label, the template new posts use, and what one post is called (item, default “entry”). They get the Channels panel and, with url, a feed. See Channels |
The rich text map
Rich text is stored as clean HTML with no classes. When a page is rendered, each element gets the classes listed for it in "rich". Change a class here and every rich text field on the site follows. The Design panel's Text tab edits this map by picking tokens.
The elements you can style are p, strong, em, h2, h3, h4, ul, ol, li, a, figure, img, figcaption, table, thead, tbody, tr, th, td, blockquote, aside, iframe, pre and code, plus "pre code" for the code inside a code block. Any other key is an error that lists these.
The classes are compiled and checked like any template’s. A bad one stops the build, reported against verso.json with the element it belongs to.
Elevate’s settings
The rest of a site’s configuration is Elevate’s, in elevate/config/.
| File | What it holds |
|---|---|
elevate.ts | Watch (folders to scan), FileTypes, Extend (CSS files to append), ClassRegex (how classes are found) and SafeList (class names Elevate should ignore) |
design.ts | The design system: every token type, built from Elevate’s defaults and your own |
syntax.ts | Custom class syntax, if you add any |
const options = {
Watch: ['./templates', './parts', './blocks', './public'],
FileTypes: ['html', 'js'],
Output: './dist',
Extend: ['./elevate/extend/fonts.css'],
ClassRegex: [
/\bclass\s*=\s*"([^"]*)"/g,
/\bclass\s*=\s*'([^']*)'/g,
],
SafeList: []
}
export const config = options
Verso compiles CSS in memory, so Output only matters if you run Elevate’s own build. Changing any of these files while the editor is open recompiles and reloads the page.
Other files at the top of a site
| Path | What it is |
|---|---|
templates/ | Page templates, one HTML file each |
parts/ | HTML shared by templates, brought in with {{ part:name }} |
templates/<type>.layout.json | The starting layout for new pages of a page type |
blocks/ | Blocks that can be stacked into block areas |
components/ | Saved arrangements of blocks, as JSON |
content/ | The pages, one folder each |
content/site.json | Shared fields and shared block areas, the same on every page |
public/ | Files copied to the site as they are: scripts, icons, fonts |
dist/ | The built site. Not kept in git |
.verso-cache/ | Resized image copies, so rebuilds are quick. Not kept in git |