> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# A new, AI-native experience for the Paddle developer docs

We've relaunched our developer docs as an AI-native experience: markdown routes, embedded Ask AI, copy-as-prompt, AI-generated summaries, and options to open in AI tools. Plus, dark mode, faster search, and a better mobile experience.


---

## What's new?

We've relaunched the Paddle developer docs as an AI-native experience, built for both the humans reading the docs in a browser and the AI agents working alongside them in editors, chat clients, and the terminal.

The new docs score 100/100 on the [afdocs spec](https://afdocs.dev/) and 75/100 on [Cloudflare's `isitagentready.com` website](https://isitagentready.com/developer.paddle.com), independent benchmarks for how well documentation works with AI tooling.

## How it works

AI agents are fast becoming the main way people build software, and increasingly how we interact with documentation. We've built the new docs to be a first-class experience for agents and humans alike, with a focus on clarity, accuracy, and ease of use.

### New docs features

- **Markdown routes**  
  Every page in the docs is now available as Markdown. Append `.md` to any doc URL to fetch the raw source, or click **Copy for LLM** on a page to copy the Markdown directly.
- **Automatic Markdown negotiation**  
  When AI agents browse the docs, we serve them the Markdown version automatically to preserve tokens. A plain-text index of every page lives at [`/llms.txt`](https://developer.paddle.com/llms.txt.md) as before.
- **Quick options to open in AI tools**  
  Every page has an **Open in…** action that takes the current page straight into ChatGPT, [Claude](https://developer.paddle.com/get-started/ai/claude-code.md), or another AI assistant, with the Markdown source prefilled as context.
- **AI-generated summaries**  
  Most pages now include a collapsible AI summary at the top, giving you a quick orientation before you dive in. If you're not interested in the summary, you can collapse it and your browser remembers your preference across pages.
- **Quick question prompts**  
  We've extended our Kapa.ai-powered docs assistant with quick question prompts throughout the docs.
- **Copy-as-prompt cards**  
  For a number of guides, we've added one-click prompts that let you copy the page context and a shaped prompt that you can paste directly into your AI assistant.

### Token efficiency

Behind the scenes, we moved from Next.js to [Astro](https://astro.build/) and spent a significant amount of time optimizing the core docs experience for speed and token efficiency. Across guides we tested, we saw a ~66% reduction in tokens consumed for the same content.

### Also included

Our docs are still written by humans, with human readers in mind. Alongside the AI features, there are a bunch of improvements for human readers of our docs, too:

- **Dark mode**  
  Toggle between light and dark mode from the docs header.
- **Improved search**  
  A massively improved, more accurate search experience across the docs.
- **Improved mobile experience**  
  Navigation, code blocks, and tables all work better on small screens.
- **New content**  
  A new [getting started section](https://developer.paddle.com/get-started.md), with a focus on the most common tasks and workflows, and an expanded [SDKs and tools section](https://developer.paddle.com/sdks.md), with links to the official SDKs, sandbox, AI and MCP servers, specs, starter kits, and community libraries.
- **New API reference**  
  An entirely rebuilt [API reference section](https://developer.paddle.com/api-reference.md), with validation, min/max limits, default values, and more surfaced in a clean layout.
- **Enhanced components across the docs**  
  Quickly copy install commands, sort data in tables, and compare features side-by-side with new components.

Every layout and component has been rebuilt to be more consistent and more readable, and make browsing our docs better.

## Next steps

The new docs are available now at [developer.paddle.com](https://developer.paddle.com) (you're here!). There's nothing you need to do to start using them.

There's no change to [the Paddle docs MCP server](https://developer.paddle.com/sdks/ai/docs-mcp.md), which is trained on our developer docs.

There are no changes to the Paddle API or Paddle.js as a result of this update. It's a non-breaking change and doesn't impact existing integrations.