Configuration
pages.config.js is the one configuration file. It is a plain JavaScript
module; the builder reads it at build time, nothing from it reaches the
browser except what the pages show. Below are the two templates’ files as
they are, then every key.
Landing page (builder-www)
Section titled “Landing page (builder-www)”pages/template-www/pages.config.js:
export default { title: 'My Landing', // the template itself is deployed here; put your own domain siteUrl: 'https://template-www.pages.gitt.one', defaultPhone: '+46 00 000 00 00', defaultEmail: 'info@example.com', // file in images/; '' renders the title as a wordmark instead logoImage: '', logoImageHeight: 40, // contact form backend and its Cloudflare Turnstile site key; // leave both empty until the form is wired up contactFormReceiverURL: '', turnstileSiteKey: '', locales: ['en'], defaultLocale: 'en', // one seed colour; the whole primary palette is derived from it brandColor: '#2563eb', // header theme: 'light' (default) or 'dark' headerTheme: 'light', // site menu; path is locale-relative ('' = home), cta: true = accent button navigation: [ { name: 'Home', path: '' }, { name: 'Contacts', path: 'contacts', cta: true }, ], // extra footer lines (legal requisites etc.) footerLines: [],};Change brandColor and rebuild: the blue of
template-www.pages.gitt.one — buttons,
icons, the wordmark, the gradient of the call to action — becomes your
colour, with the lighter and darker shades derived to keep contrast.
| Key | Required | What it does |
|---|---|---|
title | yes | Site name: the browser tab, the wordmark in the header when there is no logo, the og:title fallback |
siteUrl | yes | Canonical origin; drives the sitemap, canonical links and hreflang alternates |
defaultPhone, defaultEmail | no | Shown in the header and the footer; sections may override them |
logoImage | no | File name in images/. Empty string renders title as a gradient wordmark |
logoImageHeight | no | Height of the logo in pixels, default 40 |
brandColor | no | One seed colour. The whole primary palette (50…950) and an analogous accent for gradients are derived from it in OKLCH; button text shades are chosen for contrast. Omit it to keep the engine’s default palette |
headerTheme | no | 'light' (default) or 'dark' |
navigation | yes | The menu. path is locale-relative: '' is the home page, 'contacts' is /contacts/, '#contacts' is an anchor on the current page; an absolute URL is used as is. cta: true renders the item as the accent button. May be a map by language: { en: [...], ru: [...] } |
footerLines | no | Extra lines under the footer (legal requisites). May be a map by language |
locales, defaultLocale | no | Languages, see Languages. Omit both for a single-language site |
contactFormReceiverURL | no | Where the contact form posts |
turnstileSiteKey | no | Cloudflare Turnstile site key for the form’s spam challenge |
fontFamily | no | A family bundled in the builder ('Open Sans') — self-hosted, no external requests — or any CSS font stack of your own |
fontScale, headingScale | no | Multipliers for the type scale; headingScale applies to display sizes on top of fontScale |
portfolioUrl, portfolioBearer | no | Source for the PortfolioSection (projects pulled at build time) |
componentsGallery | no | true renders the component collection under /components/. Meant for the engine’s own site |
Knowledge base (builder-docs)
Section titled “Knowledge base (builder-docs)”pages/template-docs/pages.config.js:
export default { title: 'My Knowledge Base', // the template itself is deployed here; put your own domain siteUrl: 'https://template-docs.pages.gitt.one', description: 'Knowledge base published from a git repository', // colour of the browser UI and of the generated site.webmanifest themeColor: '#334155',};| Key | Required | What it does |
|---|---|---|
title | yes | Site name in the header and the browser tab |
siteUrl | yes | Canonical origin for the sitemap and links |
description | no | Default meta description |
themeColor | no | Colour of the browser UI and of the generated site.webmanifest |
logo | no | Path to a logo copied into the image with COPY |
favicon | no | Re-points the favicon link, e.g. to a .ico you copy into public/ |
search | no | false removes the search box and skips the index build. On by default |
locales, defaultLocale | no | Languages, see Languages |