Configuration | Cybooks

Website configuration

The main configuration file is src/configs/website-config.ts. It controls content locations and a few site-level defaults.

website-config.ts

const config = {
  blog: { contentDir: 'src/content/blog' },
  docs: { basePath: '/docs', contentDir: 'src/content/docs' },
  changelog: { contentDir: 'src/content/changelog' },
  legal: { contentDir: 'src/content/legal' },
};

Content directories

Keep content in one place and follow a predictable structure:

Content type	Directory	Notes
Blog	`src/content/blog`	Includes taxonomy for authors and categories
Docs	`src/content/docs`	Uses `meta.json` to define sidebar structure
Changelog	`src/content/changelog`	Similar to blog posts but different route
Legal	`src/content/legal`	Simple markdown pages (TOS, privacy policy)

Docs navigation is driven by meta.json files. The root file is src/content/docs/meta.json and can define sections and ordering.

The root meta.json can include separators and folders. Folders become collapsible groups in the sidebar.

{
  "title": "Documentation",
  "root": true,
  "pages": ["---Getting started---", "introduction", "installation"]
}

Note

Use stable slugs (filenames) for docs pages to keep sidebar links and any cross-references consistent.

Next steps

If you are configuring the site for the first time, the most practical follow-up is learning how to author content and then applying these settings to the data fetching and rendering pages.