> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roscigno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customize your site

> Understand what docs.json controls and how to style your custom frontend

This starter uses a custom Astro frontend with Mintlify's content tools and components. Because the frontend is yours, not every `docs.json` configuration option from the [full Mintlify reference](https://mintlify.com/docs/organize/settings) applies.

**What `docs.json` controls:** Navigation structure, page metadata, and content configuration.

**What you control:** Styling, layouts, and how your site renders. These live in your Astro project under `src/`.

> [!NOTE]
>
> If a `docs.json` option doesn't seem to have any effect, it likely isn't wired up in the Astro frontend. Check the templates in `src/` to see how configuration values are consumed, and adjust there.

## Navigation

Construct the navigation for your documentation in `docs.json`.

```json content/docs.json theme={null}
{
  "navigation": {
    "tabs": [
      {
        "tab": "Docs",
        "groups": [
          {
            "group": "Getting started",
            "pages": [
              "index",
              "quickstart"
            ]
          }
        ]
      }
    ]
  }
}
```

Page paths are relative to the `content/` directory without the `.mdx` extension. Use forward slashes for nested pages. For example, `guides/example`.

## Site metadata

Set a site name and other metadata in `docs.json`.

```json content/docs.json theme={null}
{
  "name": "My Docs",
  "favicon": "/favicon.svg",
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg"
  }
}
```

Whether these values take effect depends on how the Astro templates in `src/` reference them.

## Styling and layouts

Since this is a custom Astro project, you have direct control over how your site looks:

| Path | What it controls |
| - | - |
| `src/layouts/` | Page layout templates. |
| `src/styles/` | Global CSS and Tailwind configuration. |
| `src/components/` | Custom Astro and React components. |

To change colors, fonts, spacing, or other visual properties, edit the files in `src/` directly rather than relying on `docs.json` values like `colors` or `navbar`.

> [!TIP]
>
> Changes to files in `src/` take effect immediately when the dev server is running.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.