Documentation

How to add and structure documentation content.

Created: 1/4/2026

Adding Content

Our documentation is structured using filesystem-based routing powered by Contentlayer.

Directory Structure

Content is located in apps/docs/content.

  • Folders represent sections in the sidebar.
  • Prefix folders with numbers (e.g., 1-landing-page, 2-docs-site) to control sorting order.

Creating a Page

  1. Create a .mdx file in the appropriate folder.
  2. Add the required frontmatter at the top:
---
title: Page Title
description: Brief description for SEO and previews.
keywords:
  - keyword1
  - keyword2
image: /smart-cubed.png
date: 2026-01-01
---

Writing Content

You can write standard Markdown. Since we use MDX, you can also import and use React components.

Callouts (Alerts)

We use GitHub-flavored alerts:

[!NOTE] This is a note.

[!WARNING] This is a warning.

Code Blocks

Use triple backticks with a language identifier for syntax highlighting.

```typescript const hello = "world"; ```