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.