Support opening in AI tools, and a slight design refresh (#1032)

codykerns · web-flow · commit fd8ca31d94d9 · 2025-08-01T12:53:26.000-04:00
diff --git a/docs/dashboard-and-metrics/charts/real-time-charts.md b/docs/dashboard-and-metrics/charts/real-time-charts.md
@@ -5,8 +5,6 @@ excerpt: Overview of the key changes & improvements of our new real-time Charts
 hidden: true
 ---
 
-# Real-time Charts (Beta)
-
 We’re excited to welcome you to the beta of our new real-time Charts. We've rebuilt charts to give you faster, more flexible insights, including:
 
 - Real-time reporting on almost all charts
diff --git a/docs/dashboard-and-metrics/reconciling-with-financial-reports.md b/docs/dashboard-and-metrics/reconciling-with-financial-reports.md
@@ -4,8 +4,6 @@ slug: reconciling-with-financial-reports
 hidden: false
 ---
 
-# RevenueCat and the App Store's financial reports
-
 When managing your app's revenue and overall financial performance, you might frequently need to use both our [Revenue chart](https://app.revenuecat.com/charts/revenue) and the [App Store’s financial reports](https://developer.apple.com/help/app-store-connect/getting-paid/download-financial-reports/) for different purposes. While they both report on the financial performance of your app, there are meaningful differences in the recommended use cases and available data between those sources. Understanding these differences can help you better interpret the data and make more informed decisions.
 
 ## How the Revenue chart works
diff --git a/docs/known-store-issues/storekit.md b/docs/known-store-issues/storekit.md
@@ -2,8 +2,6 @@
 title: StoreKit Issues
 ---
 
-# StoreKit Known Issues
-
 This section covers known issues specifically related to Apple's StoreKit framework that may affect your RevenueCat integration.
 
 ## Current Issues
diff --git a/docs/known-store-issues/storekit/ios-18-4-simulator-fails-to-load-products.md b/docs/known-store-issues/storekit/ios-18-4-simulator-fails-to-load-products.md
@@ -2,8 +2,6 @@
 title: iOS 18.4 Simulator Fails to Load Products
 ---
 
-# iOS 18.4 Simulator Fails to Load Products
-
 ## Resolved
 
 Apple has resolved this issue, and it is not present in iOS 26 and above. The issue is still present in the iOS 18.4-18.5 simulators. We are keeping this page for historical reference.
diff --git a/docs/migrating-to-revenuecat/swiftystorekit.mdx b/docs/migrating-to-revenuecat/swiftystorekit.mdx
@@ -5,8 +5,6 @@ excerpt: Migrate your SwiftyStoreKit app to RevenueCat
 hidden: false
 ---
 
-# SwiftyStoreKit Migration
-
 If you use SwiftyStoreKit in your iOS app and are looking for an alternative that includes receipt validation, server-side status tracking, cross-platform support and more - RevenueCat is the ideal choice for your app!
 
 This guide describes how to integrate specific features from SwiftyStoreKit into your app. For basic RevenueCat setup instructions, see the [Quickstart guide](/getting-started/quickstart).
diff --git a/docs/offerings/virtual-currency/events.mdx b/docs/offerings/virtual-currency/events.mdx
@@ -5,8 +5,6 @@ slug: events
 hidden: false
 ---
 
-# Virtual Currency Events
-
 RevenueCat provides event tracking for virtual currency transactions, allowing you to monitor and respond to balance changes in real-time through webhooks.
 
 :::info Adjustments via API are view-only
diff --git a/docs/offerings/virtual-currency/refunds.md b/docs/offerings/virtual-currency/refunds.md
@@ -5,8 +5,6 @@ slug: refunds
 hidden: false
 ---
 
-# Refunds
-
 This guide explains how RevenueCat handles virtual currency balance adjustments when purchases are refunded, including both subscriptions and one-time purchases. When purchases that grant virtual currency are refunded, RevenueCat adjusts the customer’s balance to maintain fairness, while ensuring balances never fall below zero.
 
 ## Balance Floor
diff --git a/docs/offerings/virtual-currency/subscriptions.md b/docs/offerings/virtual-currency/subscriptions.md
@@ -5,8 +5,6 @@ slug: subscriptions
 hidden: false
 ---
 
-# Subscriptions
-
 In addition to one-time products, subscriptions can be used to grant virtual currency on a recurring basis, such as a monthly coin pack or weekly credit refill. This model helps drive predictable revenue while encouraging long-term engagement and retention.
 
 With RevenueCat’s virtual currency feature, you can configure subscriptions to automatically deliver currency to customers at regular intervals. These currencies, like tokens, gems, or credits, can then be spent on virtual goods or in-app experiences.
diff --git a/docs/projects/projects-overview.mdx b/docs/projects/projects-overview.mdx
@@ -66,6 +66,7 @@ If you are changing the App Store Connect or Google Developer account, this will
 - For Apple, these are the [app-specific shared secret](https://www.revenuecat.com/docs/service-credentials/itunesconnect-app-specific-shared-secret), the [in-app purchase key](https://www.revenuecat.com/docs/service-credentials/itunesconnect-app-specific-shared-secret/in-app-purchase-key-configuration), and the [App Store Connect API key](https://www.revenuecat.com/docs/service-credentials/itunesconnect-app-specific-shared-secret/app-store-connect-api-key-configuration). The new owner will also want to make sure their Paid Applications Agreement is signed with Apple.
 
 - For Google, these are the [service credentials](https://www.revenuecat.com/docs/service-credentials/creating-play-service-credentials). To reduce any downtime, we recommend the new owner generate these credentials in advance and test them on a RevenueCat project to make sure they are validated and working before the transfer.
+
 </details>
 
 ## Next steps
diff --git a/docs/tools/experiments-v1.md b/docs/tools/experiments-v1.md
@@ -2,12 +2,10 @@
 title: Experiments
 sidebar_label: Introduction
 slug: experiments-v1
-excerpt: A/B testing two offerings in your app
+excerpt: Take the guesswork out of pricing & paywalls
 hidden: false
 ---
 
-# Take the guesswork out of pricing & paywalls
-
 RevenueCat Experiments allow you to optimize your subscription pricing and paywall design with easy-to-deploy A/B tests backed by comprehensive cross-platform results. With Experiments, you can A/B test two different Offerings for any paywall location in your app and analyzing the full subscription lifecycle to understand which variant is producing more value for your business.
 
 :::tip
diff --git a/docs/tools/paywalls/creating-paywalls/component-properties.mdx b/docs/tools/paywalls/creating-paywalls/component-properties.mdx
@@ -4,8 +4,6 @@ slug: component-properties
 hidden: false
 ---
 
-# Component properties
-
 Paywalls are made up of individual components that you add and arrange, and those components each have their own properties to be configured that define how it looks and behaves.
 
 ## Position properties
diff --git a/docs/tools/paywalls/creating-paywalls/components.mdx b/docs/tools/paywalls/creating-paywalls/components.mdx
@@ -4,8 +4,6 @@ slug: components
 hidden: false
 ---
 
-# Components
-
 Components are the individual building blocks of your paywall that can be arranged and configured to create your own custom layout.
 
 | Component       | Parent | Description                                                                                |
diff --git a/docs/tools/paywalls/creating-paywalls/customer-states.mdx b/docs/tools/paywalls/creating-paywalls/customer-states.mdx
@@ -4,8 +4,6 @@ slug: customer-states
 hidden: false
 ---
 
-# Designing for other customer states
-
 Customers may use your paywall in many different states -- such as in dark mode, or while eligible for an introductory offer -- and these states may benefit from having their own configured properties to make your paywall work best in each situation.
 
 ## Light mode / dark mode
diff --git a/docs/tools/paywalls/creating-paywalls/localization.mdx b/docs/tools/paywalls/creating-paywalls/localization.mdx
@@ -4,8 +4,6 @@ slug: localization
 hidden: false
 ---
 
-# Localization
-
 Paywall localization can be managed through the Paywall Localization page, or inline through the Paywall Editor directly.
 
 ## Editing via the Paywall Localization page
diff --git a/docs/tools/paywalls/creating-paywalls/variables.mdx b/docs/tools/paywalls/creating-paywalls/variables.mdx
@@ -4,8 +4,6 @@ slug: variables
 hidden: false
 ---
 
-# Variables
-
 For some Paywall strings you may want to set values based on the package that’s being displayed instead of hardcoding a single value, such as when quoting a price, or describing the duration of an Introductory Offer.
 
 To make this easier and ensure accuracy, we recommend using **Variables** for these values that are package-specific.
diff --git a/docs/tools/targeting/custom-attributes.mdx b/docs/tools/targeting/custom-attributes.mdx
@@ -4,8 +4,6 @@ slug: custom-attributes
 hidden: true
 ---
 
-# Targeting by Custom Attributes
-
 With custom attributes, you can create audiences to target with unique Offerings based on any dimension that's relevant to your business.
 
 import YouTubeEmbed from "@site/src/components/YouTubeEmbed";
diff --git a/docs/tools/targeting/placements.mdx b/docs/tools/targeting/placements.mdx
@@ -1,11 +1,10 @@
 ---
 title: By Placement
 slug: placements
+sidebar_label: Targeting by Placement
 hidden: false
 ---
 
-# Targeting By Placement
-
 Use Targeting by Placement to define paywall locations in your app so that you can serve unique Offerings at each paywall location to each customer.
 
 import YouTubeEmbed from "@site/src/components/YouTubeEmbed";
diff --git a/docs/web/web-billing/localization.mdx b/docs/web/web-billing/localization.mdx
@@ -4,17 +4,17 @@ slug: localization
 hidden: false
 ---
 
-:::warning Beta translations
-Our localization support is in beta, and supported translations may include minor issues. We're working to validate these, and appreciate your input! Please [contact us](mailto:support%40revenuecat.com) or [open an issue](https://github.com/RevenueCat/purchases-js/issues) in our github repo with any corrections or general feedback on translations).
-:::
-
-## Overview
+Web Billing (formerly RevenueCat Billing) provides localization support to help you deliver a seamless purchase experience to customers around the world. The localization features allow you to present the purchase flow in your customers' preferred languages while maintaining consistent product information and pricing across regions.
 
 - Web Billing supports localization for 33 languages in the Web SDK.
 - Localization affects the entire purchase flow, including the checkout form (excluding any possible secondary payment flows such as 3D Secure authentication).
 - Product names and descriptions are not localized, and will be shown in their original form (as defined in the RevenueCat Dashboard).
 - Prices configured through [multi-currency support](/web/web-billing/multi-currency-support/) are now formatted following the selected locale in the purchase flow.
 
+:::warning Beta translations
+Our localization support is in beta, and supported translations may include minor issues. We're working to validate these, and appreciate your input! Please [contact us](mailto:support%40revenuecat.com) or [open an issue](https://github.com/RevenueCat/purchases-js/issues) in our github repo with any corrections or general feedback on translations).
+:::
+
 ### Current limitations
 
 Currently, the following limitations apply to localization support:
diff --git a/docs/web/web-billing/multi-currency-support.mdx b/docs/web/web-billing/multi-currency-support.mdx
@@ -4,8 +4,6 @@ slug: multi-currency-support
 hidden: false
 ---
 
-## Overview
-
 Web Billing (formerly RevenueCat Billing) supports multiple currencies for your web subscriptions.
 
 ### App setup
diff --git a/docs/web/web-billing/overview.mdx b/docs/web/web-billing/overview.mdx
@@ -5,8 +5,6 @@ excerpt: Overview of RevenueCat's support for web purchases
 hidden: false
 ---
 
-# RevenueCat Web overview
-
 RevenueCat Web provides a set of tools that allow you to easily start selling subscriptions and one-time purchases on the web, and connect them with the same subscriptions and entitlements on mobile — either using RevenueCat's own billing engine (RC Web Billing) or by connecting 3rd party billing engines.
 
 ## Features & use cases
diff --git a/docs/web/web-billing/payment-methods.mdx b/docs/web/web-billing/payment-methods.mdx
@@ -4,8 +4,6 @@ slug: payment-methods
 hidden: false
 ---
 
-## Overview
-
 Web Billing (formerly RevenueCat Billing) currently supports the following payment methods for charging subscription and one-time purchases:
 
 - **Credit card:** Enabled by default, supports for all major card networks, and 3D Secure authentication (via Stripe)
diff --git a/docs/web/web-billing/product-setup.md b/docs/web/web-billing/product-setup.md
@@ -1,12 +1,10 @@
 ---
-title: Product Setup
+title: Configure Web Billing
 slug: product-setup
 excerpt: Setting up your web purchases using Web Billing
 hidden: false
 ---
 
-# Configuring Web Billing
-
 To create a new Web Billing (formerly RevenueCat Billing) product, open the RevenueCat dashboard, go to your project's settings, and under "Products" click on "New", and then select your Web Billing App:
 
 ![New product button in the products screen](/docs_images/web/web-billing/new-product.png)
diff --git a/docs/web/web-billing/redemption-links.mdx b/docs/web/web-billing/redemption-links.mdx
@@ -5,8 +5,6 @@ excerpt: Allow customers to purchase products and subscriptions on the web and s
 hidden: false
 ---
 
-## Overview
-
 Redemption Links are one-time-use deep links generated after a customer completes a web purchase. These links allow customers to associate their web purchase with their account in your app. By tapping the link, customers are redirected into the app where the purchase is automatically linked to their App User ID, granting them access to the associated entitlements.
 Redemption Links can increase conversion and be incredibly useful for projects like marketing campaigns.
 
diff --git a/docs/web/web-billing/subscription-lifecycle.mdx b/docs/web/web-billing/subscription-lifecycle.mdx
@@ -5,9 +5,7 @@ excerpt: Web Billing subscription lifecycle
 hidden: false
 ---
 
-## Overview
-
-Here is an overview of the various states that a Web Billing subscription can take on, as well as the events that are being sent as a subscription transitions from one state to the other. For more details, read the following sections.
+This document explains the lifecycle of a Web Billing subscription, including the different states a subscription can be in and the events triggered during state transitions. The sections below provide more detailed information about each state and transition.
 
 ![](/docs_images/web/web-billing/subscription-lifecycle.png)
 
diff --git a/docs/web/web-billing/testing.mdx b/docs/web/web-billing/testing.mdx
@@ -5,18 +5,16 @@ excerpt: How to test your Web Billing integration
 hidden: false
 ---
 
-:::warning Ensure proper sandbox testing
-In contrast to mobile app stores, there is no intermediary between you and the customer, and no App Review before you start charging customers money. Therefore, you should make sure that you have properly tested your implementation in sandbox mode before shipping your web subscriptions.
-:::
-
-## Testing a Web SDK integration
-
 You can use Stripe's [Test Mode](https://stripe.com/docs/test-mode) or [Sandboxes](https://docs.stripe.com/sandboxes) to test your Web Billing integration.
 
 :::warning Stripe's test mode and sandboxes behave differently
 See how to use a sandbox to RevenueCat Web Billing [here](../connect-stripe-account#working-with-stripe-test-mode--sandboxes).
 :::
 
+:::warning Ensure proper sandbox testing
+In contrast to mobile app stores, there is no intermediary between you and the customer, and no App Review before you start charging customers money. Therefore, you should make sure that you have properly tested your implementation in sandbox mode before shipping your web subscriptions.
+:::
+
 ## Testing Web Purchase Links
 
 RevenueCat provides a separate sandbox link for testing, which should not be shared with customers.
diff --git a/docs/web/web-billing/web-purchase-links.mdx b/docs/web/web-billing/web-purchase-links.mdx
@@ -5,8 +5,6 @@ excerpt: Generate a RevenueCat hosted paywall and checkout flow with just a few
 hidden: false
 ---
 
-## Overview
-
 Use Web Purchase Links to enable customers to purchase a web subscription directly **without writing code**, through a RevenueCat-hosted purchase flow.
 
 Web Purchase Links support a range of use cases, with both identified and anonymous purchases. For identified users, append the customer's App User ID to the provided URL. For anonymous purchases, utilize [Redemption Links](/web/web-billing/redemption-links), which allow customers to buy subscriptions without an App User ID and later associate the purchase with their account in your app.
diff --git a/docs/web/web-billing/web-sdk.mdx b/docs/web/web-billing/web-sdk.mdx
@@ -5,8 +5,6 @@ excerpt: Offer web subscriptions with Web Billing
 hidden: false
 ---
 
-## Introduction
-
 RevenueCat's Web SDK allow you to easily sell subscriptions and other purchases in your web app. It utilizes Stripe as the payment gateway, so you'll need a Stripe account to connect with your RevenueCat account.
 
 Web Billing differs from external payment integrations in that it takes care of the purchase UI, the subscription management portal, and the recurring billing logic.
diff --git a/docs/welcome/overview.mdx b/docs/welcome/overview.mdx
@@ -1,45 +1,52 @@
 ---
-title: Welcome
+title: Welcome to RevenueCat
 slug: overview
-sidebar_label: Welcome
-excerpt: Everything you need to implement and manage in-app purchases and subscriptions
+sidebar_label: Start here
+excerpt: Build, Analyze, and Grow In-App Revenue with Ease
 ---
 
-**Build, Analyze, and Grow In-App Revenue with Ease**
+RevenueCat is the go-to platform for developers who want to focus on building amazing products—not dealing with the complexities of billing and app stores.
 
-RevenueCat is the go-to platform for developers who want to focus on building amazing products—not dealing with the complexities of billing and app stores. With dynamic paywalls, actionable analytics, and plug-and-play experimentation tools, RevenueCat helps you make smarter decisions and drive growth, whether you're just starting out or scaling to millions of customers.
+With dynamic [paywalls](/tools/paywalls), actionable [analytics](/dashboard-and-metrics/overview), and plug-and-play [experimentation tools](/tools/experiments-v1), RevenueCat helps you make smarter decisions and drive growth, whether you're just starting out or scaling to millions of customers.
+
+Get started with RevenueCat by [creating an account](https://app.revenuecat.com/signup). All you need is an email address.
 
 :::info See it in action
 We host live office hours every other Friday, where we demo the platform and answer your questions live. [Register for the next office hours →](https://app.livestorm.co/revenuecat/live-revenuecat-demo?type=detailed)
 :::
 
-## Set up your account
+## Start implementing
 
-RevenueCat accounts are free to set up, all you need is an email address.
+Get started by creating a new project and connecting to a store.
 
-<Button href="https://app.revenuecat.com/signup"
-target="\_blank">Create an account →</Button>
+<Button href="/docs/projects/overview">Create a project</Button>
 
-## Start implementing
+### Migrating existing subscriptions?
 
-:::info New!
-Check out our new [Playbooks](/playbooks/overview) section for guides and best practices for implementing different monetization models.
-:::
+Whether you have just one or one million subscribers, you can easily replace your existing setup with RevenueCat. Supercharge your business and start taking advantage of powerful features like Experiments, Paywalls, and Targeting.
 
-Get started by creating a new project and connecting to a store.
+Read our [migration guide](/migrating-to-revenuecat/migration-paths) for more information.
 
-<Button href="/docs/projects/overview">Create a project →</Button>
+## Learn more about RevenueCat
 
-### Migrating existing subscriptions?
+Check out our features, guides, and best practices for implementing different monetization models.
 
-Whether you have just one or one million subscribers, you can easily replace your existing setup with RevenueCat. Supercharge your business and start taking advantage of powerful features like Experiments, Paywalls, and Targeting. Read our [migration guide](/migrating-to-revenuecat/migration-paths) for more information.
+### Guides
+
+<FeatureItem
+  title="Playbooks"
+  subtitle="Learn best practices and proven strategies for subscription success"
+  link="/docs/playbooks/overview"
+  iconName="bookmark"
+  iconColor="var(--rc-blue-primary)"
+/>
 
-## Browse features
+### Features
 
-<FeatureItem 
-  title="Entitlements & Subscription Status" 
-  subtitle="Ensure customers have correct access even if your entitlement structure is complex." 
-  link="/docs/getting-started/entitlements" 
+<FeatureItem
+  title="Entitlements & Subscription Status"
+  subtitle="Ensure customers have correct access even if your entitlement structure is complex."
+  link="/docs/getting-started/entitlements"
   iconName="key"
   iconColor="var(--rc-blue-primary)"
 />
@@ -76,12 +83,22 @@ Whether you have just one or one million subscribers, you can easily replace you
   iconColor="var(--rc-orange-primary)"
 />
 
-:::info LLM-Optimized Documentation
-Our documentation is optimized for large language models. For AI assistants, see our [llms.txt file](/llms.txt) for structured access to key resources.
-:::
+### AI tools
+
+Our documentation is optimized for large language models.
+
+For AI assistants, see our [llms.txt file](/llms.txt) for structured access to key resources.
+
+<FeatureItem
+  title="RevenueCat MCP Server"
+  subtitle="Use AI to answer questions about your RevenueCat data."
+  link="/docs/tools/mcp/overview"
+  iconName="sparkle"
+  iconColor="var(--rc-blue-primary)"
+/>
 
 ## Not sure where to start?
 
 Talk to an expert to learn how RevenueCat can help grow your business.
 
-<Button href="https://www.revenuecat.com/talk-to-sales/">Talk to Sales →</Button>
+<Button href="https://www.revenuecat.com/talk-to-sales/">Talk to Sales</Button>
diff --git a/src/components/AIToolsContainer/AIToolsContainer.tsx b/src/components/AIToolsContainer/AIToolsContainer.tsx
diff --git a/src/components/AIToolsContainer/styles.module.css b/src/components/AIToolsContainer/styles.module.css
diff --git a/src/components/FeatureItem/FeatureItem.tsx b/src/components/FeatureItem/FeatureItem.tsx
diff --git a/src/components/FeatureItem/styles.module.css b/src/components/FeatureItem/styles.module.css
diff --git a/src/css/custom.css b/src/css/custom.css
diff --git a/src/theme/DocBreadcrumbs/Items/Home/index.tsx b/src/theme/DocBreadcrumbs/Items/Home/index.tsx
diff --git a/src/theme/DocBreadcrumbs/Items/Home/styles.module.css b/src/theme/DocBreadcrumbs/Items/Home/styles.module.css
diff --git a/src/theme/DocBreadcrumbs/StructuredData/index.tsx b/src/theme/DocBreadcrumbs/StructuredData/index.tsx
diff --git a/src/theme/DocBreadcrumbs/index.tsx b/src/theme/DocBreadcrumbs/index.tsx
diff --git a/src/theme/DocBreadcrumbs/styles.module.css b/src/theme/DocBreadcrumbs/styles.module.css
diff --git a/src/theme/DocItem/Content/index.tsx b/src/theme/DocItem/Content/index.tsx
diff --git a/static/docs_images/integrations/icons/chatgpt.png b/static/docs_images/integrations/icons/chatgpt.png
diff --git a/static/docs_images/integrations/icons/claude.png b/static/docs_images/integrations/icons/claude.png
diff --git a/static/docs_images/integrations/icons/rc.png b/static/docs_images/integrations/icons/rc.png
