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

# Reference

> Technical reference for Mercur's HTTP APIs, panel extensions, and configuration.

This section is the technical contract of the Mercur core plugin. The
[Learn](https://docs.mercurjs.com/learn/introduction.md) tab explains concepts and the
[Platform](https://docs.mercurjs.com/platform/store/overview.md) tab documents each domain's data models,
workflows, service, and events. These pages cover the HTTP APIs, the panel
extension helpers, and configuration.

## HTTP API

Mercur extends the Medusa server with three route surfaces. Start with the
conventions page: authentication, seller scoping, and pagination work the same
way across all of them.

> [card] [API conventions](https://docs.mercurjs.com/references/api/conventions.md)
>
> Authentication, seller scoping, pagination, field selection, and webhooks.

> [card] [Admin API](https://docs.mercurjs.com/references/api/admin.md)
>
> Operator routes under `/admin/*`.

> [card] [Vendor API](https://docs.mercurjs.com/references/api/vendor.md)
>
> Seller-scoped routes under `/vendor/*`.

> [card] [Store API](https://docs.mercurjs.com/references/api/store.md)
>
> Storefront routes under `/store/*`.

## Panel extensions

File-based helpers for extending the Admin and Vendor panels without forking.

> [card] [Overview](https://docs.mercurjs.com/references/panel-extensions/overview.md)
>
> Typed targets, persistence, and how the helpers fit together.

> [card] [Widgets](https://docs.mercurjs.com/references/panel-extensions/widgets.md)
>
> `defineWidgetConfig`: zones, config, and component props.

> [card] [Custom Fields](https://docs.mercurjs.com/references/panel-extensions/custom-fields.md)
>
> `defineCustomFieldsConfig`: forms, displays, and list columns.

> [card] [Create a new page](https://docs.mercurjs.com/references/panel-extensions/create-page.md)
>
> `defineNavigationConfig` and `createFormHelper`.

## Configuration

> [card] [Configuration](https://docs.mercurjs.com/references/configuration.md)
>
> `withMercur()`, environment variables, and provider options.

> [card] [Platform modules](https://docs.mercurjs.com/platform/store/overview.md)
>
> Data models, workflows, service, and events for each domain.


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