# Developer Portal overview

<span id="what-is-the-dev-portal" />

The Zuplo Developer Portal gives your API consumers a place to read
documentation, explore your API, and manage their API keys. It combines API
reference documentation from your OpenAPI specifications with pages you write in
Markdown, MDX, or React.

<span id="build-deploy-and-hosting" />

Zuplo builds, deploys, and hosts the portal. The portal uses Zudoku for content,
configuration, and customization.

<Framed>

![Zuplo Developer Portal](../../public/media/introduction/image-1.png)

</Framed>

<span id="what-features-are-available" />

## What you can do

Use the Developer Portal to:

- Generate API reference documentation from your OpenAPI specifications and let
  readers test requests in the API Explorer.
- Publish guides and custom pages in Markdown, MDX, or React.
- Let consumers manage their keys when you use Zuplo's API key management.
- Show subscription quota usage with the
  [monetization usage dashboard](../articles/monetization/developer-portal.md#usage-dashboard).
- Customize the portal's theme, install modules, and use a custom domain.

<span id="why-the-new-dev-portal" />

## Core concepts

The portal combines three parts:

| Part                                                     | Purpose                                                               |
| -------------------------------------------------------- | --------------------------------------------------------------------- |
| OpenAPI specifications                                   | Describe the API operations shown in the reference and API Explorer.  |
| Documentation pages                                      | Provide guides and other content you write for your API consumers.    |
| [Configuration file](./zudoku/configuration/overview.md) | Set navigation, appearance, authentication, and other portal options. |

You can [work on the portal locally](../getting-started/dev-portal/local.mdx) to
preview content and configuration changes before deployment. Zuplo manages
hosting, and you can assign a [custom domain](../articles/custom-domains.mdx)
such as `docs.example.com`.

<span id="how-to-get-started" />

## Next steps

- [Build your first developer portal](../getting-started/dev-portal/portal.mdx)
  in the Zuplo Portal, then test an authenticated API request.
- Review the [configuration file](./zudoku/configuration/overview.md) to set up
  your portal's content and navigation.
- [Add a custom domain](../articles/custom-domains.mdx) for your published
  portal.

<span id="feedback" />

For help with your developer portal, contact
[support@zuplo.com](mailto:support@zuplo.com).