Deneb ReactJs documentation

Branding

Change the logo, favicon, page titles, colours and fonts, and rebuild the CSS if you want deeper changes.

Your own CSS goes in custom.css

Put every design change in public/assets/css/custom.css. It loads after the theme’s CSS, so what you write there wins. Theme updates never overwrite it. Do not edit deneb.css or deneb.rtl.css.

Colours

The theme’s colours are CSS variables that start with --dn-. Change them in custom.css:

:root {
  --dn-accent: #0ea5e9;
}

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

The first block is light mode. The second is dark mode. Set both so your colour works in each.

These are the main variables, from styles/deneb/tokens.css in the source/ folder:

Variable What it controls
--dn-accent The main brand colour: buttons and highlights
--dn-accent-soft A pale version of the accent, for backgrounds
--dn-on-accent Text colour on top of the accent
--dn-mark The underline swashes and small highlights
--dn-page The page background
--dn-surface, --dn-surface-2 Soft grey bands and cards
--dn-line, --dn-line-strong Borders and dividers
--dn-ink Headings
--dn-text Body text
--dn-muted Quieter text
--dn-radius, --dn-radius-lg How round the corners are

If the accent is a light colour, make --dn-on-accent dark so button text stays readable. Check contrast in both modes.

Write your own CSS with logical properties, such as margin-inline-start instead of margin-left. Then your changes also work in the right-to-left version.

The logo is not a picture. components/Logo.js writes your site title in lowercase, followed by a small dot. To change the name, edit title in content/site.yml.

To use your own logo image, replace the contents of components/Logo.js with your image inside the same link:

import Link from 'next/link';
import { site } from '@/lib/content';
import { t } from '@/lib/i18n';

export default function Logo() {
  const title = site().title;
  return (
    <Link className="dn-logo" href="/" aria-label={t('logo_label', title)}>
      <img src="/assets/img/logo.svg" alt="" height="32" />
    </Link>
  );
}

Put the file at public/assets/img/logo.svg. Keep the aria-label, so screen readers still hear the site name. The same component draws the logo in the header and the footer.

Favicon

Replace public/assets/favicon.svg. It is linked in app/layout.js.

Page title and description

The site title and description come from content/site.yml. Each page sets its own title and description in its front matter. Page titles show as “Page | Your title”.

Fonts

The theme uses Poppins, loaded from public/assets/fonts/. For an Arabic, Persian or Urdu site (lang set to ar, fa or ur), the theme does not preload Poppins.

To use another font:

  1. Put the .woff2 files in public/assets/fonts/.
  2. In custom.css, add an @font-face for them, then set the font on body and on headings:
@font-face {
  font-family: "My Font";
  src: url("/assets/fonts/my-font.woff2") format("woff2");
  font-weight: 400;
  font-display: swap;
}

body {
  font-family: "My Font", sans-serif;
}

Check the font’s licence allows web use. The Poppins licence is in public/assets/fonts/OFL.txt.

Rebuild the CSS (optional)

For deeper changes, the zip has a source/ folder with the CSS source. It uses Bootstrap’s Sass plus the theme’s own files in source/styles/deneb/: colors.css, tokens.css, base.css, components.css.

cd source
npm install
npm run css

This rebuilds public/assets/css/deneb.css, deneb.rtl.css and public/assets/js/deneb.js. Updates replace these files, so keep small changes in custom.css, and use the source build only when you really need it.

npm run css:watch rebuilds when you save. npm run palette runs scripts/palette.mjs, which generates the colour scales in colors.css. Read the comment at the top of that file before you use it.