skip to content
jcode

Guides

What it is#

This section contains step-by-step guides for working with jcode.

Adding a page#

Create a new markdown file in src/content/docs/<group>/<slug>.md with the required frontmatter:

---
title: "My Page"
description: "One sentence describing the page."
group: "guides"
order: 10
updated: 2026-05-02
---

The page appears in the sidebar automatically — no registration step required.

Adding a new group#

  1. Add the group to site.config.yaml under nav.groups:
nav:
  groups:
    - id: my-group
      label: My Group

  1. Add the group id to the group enum in src/content.config.ts.

  2. Add it to VALID_GROUPS in scripts/validate_frontmatter.py.

Customising the theme#

Edit site.config.yaml. Color tokens, font stacks, and dark-mode overrides all live there. Changes take effect on the next npm run dev or npm run build.