Skip to main content

Overview

This section documents everything that has been customized beyond a stock Docusaurus install: custom components, deployment settings, and known issues. It is meant as a reference for future you, not for site visitors.

CustomizationWhere to change itDetails
Gallery componentsrc/components/GalleryGallery
Panel component (soft-bordered content block)src/components/PanelPanel
Homepage features rowsrc/components/HomepageFeatures/index.jsHomepage features
Page diagrams (per-experience-page SVG figures)src/components/*Diagrams foldersPage diagrams
Release notes page mockups (text/content of each sample)src/components/*Mockup folders used by the three release-notes-*.mdx pagesRelease notes page mockups
Deploymentnpm run deploy, env vars USE_SSH / GIT_USERDeployment
Known build issuesn/aTroubleshooting
Navbar itemsdocusaurus.config.jsNavbar
Footer links and colordocusaurus.config.js, src/css/custom.cssFooter
Title, tagline, favicon, social card, analyticsdocusaurus.config.jsSite metadata
Homepage tagline lines and iconsdocusaurus.config.js, src/pages/index.module.css, static/img/home-page/Hero tagline
Blog RSS/Atom feeds, authoring warningsdocusaurus.config.jsBlog feeds and authoring checks
Broken-link checking, future flags, "Edit this page" linksdocusaurus.config.jsBuild flags and edit links
Image sizing syntax + click-to-zoomplugins/remark-image-size.mjs, docusaurus-theme-zoom-imageImage handling
Blog card look, tag styling, swizzled blog componentssrc/theme/BlogPostItem/*, src/theme/TagsListInline, src/theme/BlogTagsPostsPageBlog post cards and tags
Global layout/spacing/table CSS not covered abovesrc/css/custom.cssGlobal CSS overrides
Blog post series grouping in the sidebarsrc/data/blogSeries.ts, src/theme/BlogSidebar/*Blog post series
Palettesrc/css/custom.cssColors
Per-page TOC built from panel captions instead of headingsplugins/remark-panel-toc.mjs, frontmatter toc_source: panelsPanel-based table of contents
Typefacedocusaurus.config.js, src/css/custom.cssFonts
/samples demo docs instance (sample product user guide, not in navbar)docusaurus.config.js, samples/, sidebarsSamples.jsThe /samples section
{@include: path} content reuse across docs, blog, samples, and pagesplugins/remark-includes.mjsContent includes across sections
Site search (local index, no external service)docusaurus.config.jsSearch
Norway Data API reference page (Scalar, loaded only on that page; redirects for the API's old URLs)src/pages/api-reference.js, src/css/scalar-api-reference.css, netlify.tomlThe API reference page
Security headers and Content Security Policy (with inline script hashes, generated each build)netlify.toml, plugins/csp-headers-plugin.mjsSecurity headers
Repo and CI hardening (rulesets, Dependabot, CodeQL, SHA-pinned Actions, no install scripts)GitHub settings, .github/, netlify.toml, tools/netlify-cli/Repository and CI security