Deneb Jekyll documentation

Colours and fonts

Change the colours, fonts and shapes with a few lines in assets/css/custom.css.

Put your own CSS in assets/css/custom.css. It loads after the theme’s CSS, so your rules win. Theme updates never overwrite it.

Change the brand colour

The accent colour (the amber of the buttons and highlights) is --dn-accent. Set it for light mode and dark mode:

:root { --dn-accent: #0ea5e9; }
[data-bs-theme="dark"] { --dn-accent: #38bdf8; }

Check the text on your new colour is easy to read. The text colour on buttons is --dn-on-accent.

The tokens

These variables are defined in styles/deneb/tokens.css. Light values come first, then the dark values under [data-bs-theme="dark"].

Token What it controls
--dn-page The page background.
--dn-surface, --dn-surface-2 Cards and soft backgrounds.
--dn-line, --dn-line-strong Borders and dividers.
--dn-ink Headings.
--dn-text Body text.
--dn-muted Quiet text.
--dn-accent The brand colour.
--dn-accent-soft A pale version of the brand colour.
--dn-on-accent Text on the brand colour.
--dn-mark The underline swash and small highlights. Never used for text.
--dn-radius, --dn-radius-lg Corner roundness.
--dn-shadow-sm, --dn-shadow, --dn-shadow-lg Shadows.
--dn-section The space above and below each section.

Example: sharper corners and less space between sections.

:root {
  --dn-radius: .5rem;
  --dn-radius-lg: 1rem;
  --dn-section: clamp(3rem, 2rem + 4vw, 5rem);
}

Set a token under [data-bs-theme="dark"] too if you want a different value in dark mode.

The palette

The base colours are variables such as --navy-950, --amber-300 and --slate-800, in shades from 50 to 950. Use them in your own CSS or point a token at one:

:root { --dn-accent: var(--green-400); }

The /style-guide/ page of your site shows every colour, type size and component.

Light and dark mode

A switch in the header changes the mode. The choice is saved in the visitor’s browser, and the first visit follows their system setting.

Fonts

Deneb uses Poppins, with files in assets/fonts/ (weights 400, 500 and 600). To use another font, load it in your own CSS and set Bootstrap’s font variable:

@font-face {
  font-family: "My Font";
  font-weight: 400;
  font-display: swap;
  src: url("../fonts/my-font-400.woff2") format("woff2");
}
:root { --bs-body-font-family: "My Font", system-ui, sans-serif; }

Put the font file in assets/fonts/. Arabic, Persian and Urdu pages use the system font, because Poppins has no Arabic letters.

Write RTL-safe CSS

Use logical properties, so your changes also work in the right-to-left version: margin-inline-start instead of margin-left.

Change the design itself (optional)

The download has a source/ folder with the Sass and CSS source. You need Node.js 20 or newer.

cd source
npm install
npm run css

This rebuilds assets/css/deneb.css, assets/css/deneb.rtl.css and the theme JavaScript. npm run css:watch rebuilds when you save. Most changes do not need this: use custom.css first.