---
title: Docs
icon: book-closed
description: Set up and run the Reloop documentation site locally.
---
> For the complete documentation index, see [llms-docs.txt](/llms-docs.txt) or the site index [llms.txt](/llms.txt). Full docs corpus: [llms-full-docs.txt](/llms-full-docs.txt). Prefer markdown URLs (append `.md`) for agent consumption. Product skill: [skill.md](/skill.md).


This documentation site — MDX guides, API reference, and local setup docs.

<Tip>
Run [`bun setup`](/docs/setup) once from the monorepo root before starting individual apps.
</Tip>


## Overview

| Property | Value |
| :--- | :--- |
| **Directory** | `apps/frontend/docs` |
| **Port** | `3003` |
| **Local URL** | [https://local.reloop.sh/docs](https://local.reloop.sh/docs) |
| **Direct URL** | [http://localhost:3003](http://localhost:3003) |
| **Stack** | Next.js · MDX · Tailwind CSS |


## Quick start

From the monorepo root (after [`bun setup`](/docs/setup)):

```bash
bun fe:docs:dev
```

Or start every frontend together:

```bash
bun frontend:dev
```

Turbopack serves the app on port `3003`. Prefer [https://local.reloop.sh/docs](https://local.reloop.sh/docs) when Caddy is running.


## Environment

Committed local defaults live in `apps/frontend/docs/.env` (and `.env.dev`). Fresh clones already have them; `bun env:setup` / `bun setup` recreate or merge missing keys.

```bash
NEXT_PUBLIC_URL=https://local.reloop.sh
```

| Variable | Required | Default |
| :--- | :--- | :--- |
| `NEXT_PUBLIC_URL` | No | `https://reloop.sh` — canonical URLs, OG metadata, and public origin |


## Content structure

| Path | Purpose |
| :--- | :--- |
| `content/docs/setup/` | Local development setup guides (this section) |
| `content/docs/api/` | Auto-generated API reference |
| `content/docs/**/meta.json` | Sidebar navigation and ordering |


## Commands

| Command | Description |
| :--- | :--- |
| `bun fe:docs:dev` | Start dev server with Turbopack |
| `bun run --filter=fe-docs build` | Build and validate all MDX pages |
| `bun run --filter=fe-docs start` | Run production build |
| `bun run --filter=fe-docs generate:api-docs` | Regenerate API docs from OpenAPI specs |


## Next

<CardGroup cols={2}>
  <Card icon="rocket" title="Setup" href="/setup">
    One-command local bootstrap
  </Card>
  <Card icon="globe" title="Port reference" href="/setup/port">
    Gateway routes and ports
  </Card>
  <Card icon="shapes" title="Overview" href="/setup/overview">
    Monorepo layout and stack
  </Card>
  <Card icon="browser" title="Web" href="/setup/frontend/web">
    Marketing site setup
  </Card>
</CardGroup>