Restructure documentation navigation

[mintlify]

Reorganized documentation into a clearer structure with new sections for Introduction, Primitives, Events, and Analytics. Created comprehensive pages covering paywalls, workflows, triggers, experiments, audiences, product buckets, event tracking, and third-party integrations.

Files Changed

New Pages Created

• introduction/what-you-can-do.mdx
• introduction/billing-setup.mdx
• introduction/contact.mdx
• sdk-quickstarts/overview.mdx
• sdk-quickstarts/paywall-presentation.mdx
• sdk-quickstarts/feature-availability.mdx
• sdk-quickstarts/fallbacks.mdx
• sdk-quickstarts/storekit-testing.mdx
• primitives/paywalls.mdx
• primitives/paywalls/localization.mdx
• primitives/paywalls/product-buckets.mdx
• primitives/workflows.mdx
• primitives/triggers.mdx
• primitives/experiments.mdx
• primitives/audiences.mdx
• primitives/product-buckets.mdx
• events/custom-paywall-events.mdx
• events/revenue-tracking.mdx
• analytics/third-party-integrations.mdx
• migrations/overview.mdx

Modified Files

• docs.json - Updated navigation structure with new groups and page organization

---

Note

Medium Risk
Moderate risk of broken links or orphaned pages due to the large navigation reshuffle and many new/renamed doc routes, though changes are documentation-only.

Overview
Reorganizes Mintlify docs navigation in docs.json into clearer top-level sections (Introduction, SDK Quickstarts, Primitives, Events, Analytics, Migrations) and nests paywall-related content under a new subgroup.

Adds a large set of new MDX pages covering primitives (paywalls, workflows, triggers, experiments, audiences, product buckets), event/revenue tracking, third-party analytics forwarding, SDK quickstarts (per-platform plus fallbacks/feature availability), and a migrations overview, updating the docs IA to point at these new routes.

^{Reviewed by Cursor Bugbot for commit 48a1352. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Overview page links to non-existent iOS page slug

High Severity

The iOS card links to /sdk-quickstarts/ios but the actual file is i-os.mdx, so the correct Mintlify slug is /sdk-quickstarts/i-os. This results in a broken link on the SDK overview page — the primary entry point for developers choosing a platform.

 

[cursor]

Quickstart SDK links point to old pre-restructure paths

High Severity

The SDK cards link to old paths (/sdk/quickstart-ios, /sdk/quickstart-android, /sdk/quickstart-react-native, /sdk/quickstart-flutter) instead of the new restructured paths (/sdk-quickstarts/i-os, /sdk-quickstarts/android, /sdk-quickstarts/react-native, /sdk-quickstarts/flutter). This directs users from the new quickstart page to outdated SDK pages that are no longer part of the navigation.

 

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[cursor]

Quickstart revenue and fallback links use old paths

Medium Severity

The revenue reporting link on line 80 uses a hardcoded absolute URL (https://docs.tryhelium.com/guides/revenue-reporting) pointing to the old guide path instead of the new /events/revenue-tracking page. The fallback link on line 92 points to /guides/fallback-bundle instead of /sdk-quickstarts/fallbacks. Both paths were removed from navigation in this restructure.

 

[cursor]

SDK docs link to old guide paths

Medium Severity

All four new SDK quickstart pages (i-os.mdx, android.mdx, flutter.mdx, react-native.mdx) link to /guides/third-party-analytics and /guides/fallback-bundle, which are old paths removed from the navigation. The restructured equivalents are /analytics/third-party-integrations and /sdk-quickstarts/fallbacks. Users following these links arrive at pages outside the new nav structure.

Additional Locations (2)

• sdk-quickstarts/android.mdx#L226-L235
• sdk-quickstarts/flutter.mdx#L198-L207