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.
Logo
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:
- Put the
.woff2files inpublic/assets/fonts/. - In
custom.css, add an@font-facefor them, then set the font onbodyand 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.