Theme

Document

Doc-only chrome lives in --novem-* variables that don't travel to charts or grids: cover, running header, page numbers, table styling, callouts and content elements. General colours come from the Colors page.

AI assisted, human approved — novem uses AI to review and keep our documentation up to date.

Novem documents draw their general colours, fonts and surfaces from the Colors primitives that every visualisation consumes. The variables on this page cover document-only chrome: the cover page, running header and footer, page numbers, tables, callouts and the inline content elements that show up inside body copy.

The Aliases column lists named-color tokens that resolve to the variable when used in API instructions.

Tables in novem documents follow a single set of theme tokens that covers the header row, the alternating stripe, the cell border and the totals or section rows that often appear at the bottom or between groups of rows.

NameLightDarkAliases
--novem-table-header-bg--novem-primary-surface--novem-primary-surface
--novem-table-header-text--novem-on-primary--novem-on-primary
--novem-table-stripe-bg#f8f9fa#1f2940
--novem-table-border#e5e7eb#2a3a4a
--novem-table-total-bg#e9ecef#2a2a3e
--novem-table-total-text--novem-text--novem-text
--novem-table-section-bg--novem-surface--novem-surface

Novem callouts draw their semantic colour from the Status indicators on the Colors page (--novem-ok, --novem-warn, --novem-err and --novem-info plus their -bg and -on-* companions). The visual treatment of the callout box itself is themed here — the border style and width, the corner radius and the inner padding. These primitives sit alongside the colour tokens because they're inseparable from callout theming in practice.

NameLightDarkAliases
--novem-callout-border-styledasheddashed
--novem-callout-border-width2px2px
--novem-callout-radius--novem-radius--novem-radius
--novem-callout-pad12px 16px12px 16px

Inline marks inside body text — highlights, marked spans, definition emphasis — are controlled through a small pair of tokens.

NameLightDarkAliases
--novem-mark-bg#fff3cd#664d03
--novem-mark-text--novem-text--novem-text

The author byline is the small block that displays a sender or author alongside the avatar, name and handle. It shows up in mails as the "from" header and in docs that surface authorship metadata.

NameLightDarkAliases
--novem-author-name-text--novem-text--novem-text
--novem-author-handle-text--novem-text-muted--novem-text-muted
--novem-author-avatar-bg--novem-surface-muted--novem-surface-muted
--novem-author-avatar-border--novem-border--novem-border

A call to action is a styled content link that points the reader at another resource — a "Read more", "Open dashboard" or "View report" block. It's especially common in mails, where it acts as the visual focal point of the message, and shows up in docs and grids whenever the content needs to direct the reader somewhere else. A CTA is a piece of content rather than a UI button, so the size primitives sit alongside the colour ones.

NameLightDarkAliases
--novem-cta-bg--novem-primary--novem-primary
--novem-cta-text--novem-on-primary--novem-on-primary
--novem-cta-border--novem-primary--novem-primary
--novem-cta-radius--novem-radius--novem-radius
--novem-cta-pad12px 24px12px 24px

A page can declare a free-form type: value in its meta to receive a matching CSS class on the page itself. Themes use this hook to apply page-specific styling without inventing per-page tokens.

{{ page type: centered }}
# A centered page

Vislib emits novem--doc--page--type-centered on .novem--doc--page, alongside the existing data-page-type attribute and the --doc-title / --doc-author / --doc-date custom properties — so all type-specific theming sits on a single element:

.novem--doc--page--type-centered .novem--doc--page-content {
  align-items: center;
  justify-content: center;
}

In the continuous blog/web flow the same class is applied to the .novem--doc--blog-header (cover-style entries) or .novem--doc--blog-content section that stands in for a page, so a single selector keeps working across both layouts. The value is sanitised before it reaches the DOM:

  • Only the first whitespace-delimited word is used — type: cover sheet becomes cover
  • Lowercased
  • Reduced to [a-z0-9] — hyphens, underscores and other punctuation are stripped
  • Leading digits are removed — type: 2col becomes col
  • An empty result is dropped, so no class is added

The cover page sits at the start of a document and typically uses the brand surface colours from the Colors page. The variables below let you override those defaults specifically for the cover without affecting other surfaces.

NameLightDarkAliases
--novem-cover-bg--novem-primary-surface--novem-primary-surface
--novem-cover-text--novem-on-primary--novem-on-primary
--novem-cover-text-muted--novem-on-primary-muted--novem-on-primary-muted
--novem-cover-accent--novem-accent--novem-accent

The running header that appears at the top of every page has its own small set of tokens for the background, the bottom rule and the text.

NameLightDarkAliases
--novem-page-header-bgtransparenttransparent
--novem-page-header-border--novem-border--novem-border
--novem-page-header-text--novem-text-muted--novem-text-muted

The running footer follows the same pattern as the header, with a separate token for the page number colour because brands often want it to stand out.

NameLightDarkAliases
--novem-page-footer-text--novem-text-muted--novem-text-muted
--novem-page-number-color--novem-primary--novem-primary

Page padding is controlled per direction so you can tune portrait and landscape layouts independently.

VariableDefault (portrait)Default (landscape)
--novem-spacing8px8px
--novem-page-pad-top40px32px
--novem-page-pad-right60px50px
--novem-page-pad-bottom40px32px
--novem-page-pad-left60px50px

A small set of non-colour primitives controls the corner radius, the default shadow and the table cell padding.

VariableDefault
--novem-radius4px
--novem-shadow0 2px 8px rgba(0,0,0,0.1)
--novem-table-cell-pad10px 12px