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

# Global settings

> Configure GoalGen documentation with docs.json (Mintlify)

Mintlify’s site configuration lives in **`docs.json`** at the root of this docs app (`apps/docs`). The legacy **`mint.json`** format is deprecated; this repo uses **`docs.json`** only.

<Info>
  Full property reference: [Mintlify docs.json schema](https://mintlify.com/docs/organize/settings-reference). Required fields include `theme`, `name`, `colors.primary`, and `navigation`.
</Info>

## This repository

| File                  | Role                                                                                            |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| `apps/docs/docs.json` | Theme, name, colors, logo, navigation (tabs + groups), navbar, footer, global anchors.          |
| `apps/docs/**/*.mdx`  | Page content; every page you want in the sidebar must appear under `navigation` in `docs.json`. |

### Example structure

GoalGen uses two top-level **tabs** in `navigation.tabs`: **Documentation** (Get Started, Creator Studio, Essentials) and **API Reference**. Sidebar **anchors** (Documentation, Community, Blog) are under `navigation.global.anchors`.

```json theme={null}
{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "mint",
  "name": "GoalGen",
  "colors": {
    "primary": "#0D9373",
    "light": "#07C983",
    "dark": "#0D9373"
  },
  "navigation": {
    "tabs": [
      {
        "tab": "Documentation",
        "groups": [
          {
            "group": "Creator Studio",
            "pages": [
              "creator-studio/overview",
              "creator-studio/content-library",
              "creator-studio/rbac"
            ]
          }
        ]
      }
    ],
    "global": {
      "anchors": []
    }
  },
  "navbar": {
    "links": [{ "label": "Support", "href": "mailto:hello@goalgen.ai" }],
    "primary": {
      "type": "button",
      "label": "GitHub",
      "href": "https://github.com/DLT-CAFE/goalgen"
    }
  }
}
```

<Tip>
  Edit **`docs.json`** when you add a new MDX page, then add its path (without `.mdx`) to the right `group.pages` array.
</Tip>

## Navbar and footer

* **`navbar.links`** — Text links (e.g. Support).
* **`navbar.primary`** — Primary call-to-action button (`type`, `label`, `href`).
* **`footer.socials`** — Keys such as `github`, `x`, `linkedin` with profile URLs.

## Related

<CardGroup cols={2}>
  <Card title="Navigation" icon="map" href="/essentials/navigation">
    How sidebar navigation maps to `docs.json`.
  </Card>

  <Card title="Mintlify settings" icon="book" href="https://mintlify.com/docs/organize/settings-reference">
    Official schema for every `docs.json` field.
  </Card>
</CardGroup>