Reference

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"
  }
}
KeyDefaultWhat 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
urlnoneWhere the live site is. When set, a build writes sitemap.xml and an RSS feed for each channel. A trailing slash is dropped
basenoneThe 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
indexfalseWhen 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/.

FileWhat it holds
elevate.tsWatch (folders to scan), FileTypes, Extend (CSS files to append), ClassRegex (how classes are found) and SafeList (class names Elevate should ignore)
design.tsThe design system: every token type, built from Elevate’s defaults and your own
syntax.tsCustom 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

PathWhat it is
templates/Page templates, one HTML file each
parts/HTML shared by templates, brought in with {{ part:name }}
templates/<type>.layout.jsonThe 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.jsonShared 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