> For the complete documentation index, see [llms.txt](https://docs.soroswap.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soroswap.finance/claude.md).
# CLAUDE.md
## Entry summary
Public product documentation for Soroswap Finance: the AMM, the Aggregator and the swap API. No application code lives here, only 93 MDX pages, one static HTML demo and shared assets. The site is built by **Mintlify** (`docs.json:2`, theme `mint` at `docs.json:3`). Navigation is three tabs plus 236 redirects, all in `docs.json`. `CLAUDE.md` and `docs/` are excluded from the build via `.mintignore`. No `package.json` and no CI workflow are committed, so the publish trigger and the public domain are configured outside this repo: *TBD, unverified*. It documents `soroswap/core`, `soroswap/aggregator`, the Soroswap API service, `soroswap/sdk` and `soroswap/token-list`. See "Cross-repo dependencies" below.
## Serving locally to see a change
```bash
npx mint@latest dev --port 3333
```
Hot reload picks up edits. One check before committing:
```bash
npx mint@latest broken-links
```
That command also parses every page, so an MDX syntax error surfaces there even if the link check itself passes. A page that fails to parse is reported by file and position.
## MDX rules that differ from plain Markdown
Every page is parsed as MDX. Things that silently worked in GitBook break the build here:
* HTML comments are `{/* ... */}`, never ``.
* Void tags self-close: ` `, ``, ``.
* A literal `<` or `{` in prose starts JSX. Keep placeholders like `` and expressions like `a <-> b` inside backticks or code fences.
* Image paths are root-relative (`/images/foo.png`). Relative paths do not resolve.
* Callouts are components: ``, ``, ``, ``, ``, ``.
* Cards are `` inside ``.
* LaTeX works natively: `$...$` inline, `$$...$$` blocks.
* No GitBook syntax survives: no `{% hint %}`, no `{% embed %}`, no ``. Use ``, a raw `