sk/update search

.github/workflows/update-search.yml

@@ -0,0 +1,32 @@
+name: Update Mintlify Search
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref }}
+  cancel-in-progress: true
+
+on:
+  push
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+
+      - name: Install Mintlify Search Adapter
+        run: npm install -g @mintlify/search-ingest
+
+      - name: Update Mintlify Chunks
+        env:
+          MINTLIFY_API_HOST: ${{ secrets.MINTLIFY_API_HOST }}
+          MINTLIFY_API_KEY: ${{ secrets.MINTLIFY_API_KEY }}
+          MINTLIFY_ORGANIZATION_ID: ${{ secrets.MINTLIFY_ORGANIZATION_ID }}
+          MINTLIFY_DATASET_ID: ${{ secrets.MINTLIFY_DATASET_ID }}
+          NODE_OPTIONS: --max-old-space-size=8192
+        run: "mintlify-search-ingest --path . -r https://cursor.com/docs"

advanced/subpath/route53-cloudfront.mdx

@@ -8,24 +8,24 @@
 
 To host your documentation at a `/docs` subpath using AWS Route 53 and CloudFront, you need to configure your DNS provider to point to your CloudFront distribution.
 
 ## Proxies with Vercel deployments
 
 If you use AWS CloudFront as a proxy with Vercel deployments, you must configure CloudFront to avoid interfering with Vercel's domain verification and SSL certificate provisioning.
 
 Improper CloudFront configuration can prevent Vercel from provisioning Let's Encrypt SSL certificates and cause domain verification failures.
 
 ### Required path allowlist
 
 CloudFront must allow traffic to these specific paths without caching or blocking:
 
 - `/.well-known/acme-challenge/*` - Required for Let's Encrypt certificate verification
 - `/.well-known/vercel/*` - Required for Vercel domain verification
 
 These paths should be configured to bypass CloudFront caching and pass through directly to your origin.
 
 ### Header forwarding requirements
 
 You must create a custom origin request policy that forwards the `HOST` header and client IP information correctly. This is critical for Vercel's verification processes.
 
 1. Create a custom origin request policy named `VercelCloudFrontProxy`.
 2. Include the `Origin` and `CloudFront-Viewer-Address` headers.
@@ -67,9 +67,9 @@
 2. Find your staging URL that mirrors the main domain. This is highly variant depending on how your landing page is hosted. For example, the Mintlify staging URL is [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app).
 
 <Info>
   If your landing page is hosted on Webflow, use Webflow's staging URL. It would look like `.webflow.io`.
 
   If you use Vercel, use the `.vercel.app` domain available for every project.
 </Info>
 
 3. Create a new Origin and add your staging URL as the "Origin domain".
@@ -86,7 +86,7 @@
 
 ## Set behaviors
 
 Behaviors in CloudFront enable control over the subpath logic. At a high level, we're looking to create the following logic.
 
 - **If a user lands on /docs**, go to `[SUBDOMAIN].mintlify.dev`.
 - **If a user lands on any other page**, go the current landing page.
@@ -101,7 +101,7 @@
 
 ### `/.well-known/*`
 
 Create behaviors for Vercel domain verification paths with a **Path pattern** of `/.well-known/*` and set **Origin and origin groups** to your docs URL.
 
 For "Cache policy", select **CachingDisabled** to ensure these verification requests pass through without caching.
 
@@ -110,8 +110,8 @@
 </Frame>
 
 <Info>
 If `.well-known/*` is too generic, it can be narrowed down to 2 behaviors at a minimum for Vercel:
   - `/.well-known/vercel/*` - Required for Vercel domain verification
   - `/.well-known/acme-challenge/*` - Required for Let's Encrypt certificate verification
 </Info>
 
@@ -158,6 +158,29 @@
 
 2. Select **Save changes**.
 
+### Additional behaviors for layout stability
+
+To prevent layout shifts and ensure smooth navigation, add these additional behaviors for static asset handling:
+
+#### `/mintlify-assets/_next/static/*`
+
+Create a behavior with a **Path pattern** of `/mintlify-assets/_next/static/*` to serve static assets efficiently:
+
+- Set **Origin and origin groups** to your `.mintlify.dev` URL
+- Set **Cache policy** to **CachingOptimized** 
+- Set **Origin request policy** to **AllViewerExceptHostHeader**
+
+This behavior should be ordered **above** the default behavior in your behaviors list, as CloudFront evaluates them in order.
+
+#### Update default behavior for app router navigation
+
+For your **Default (*)** behavior, ensure these settings to handle HTML and app router navigation properly:
+
+- Set **Cache policy** to **CachingDisabled** (since RSC ?_rsc= payloads vary and shouldn't be cached)
+- Set **Origin request policy** to **AllViewerExceptHostHeader**
+
+These configurations prevent the sidenav from snapping up and down during navigation by ensuring only the new page's MDX content is fetched while keeping layout assets stable.
+
 ### Check behaviors are set up correctly
 
 If you follow the above steps, your behaviors should look like this:
@@ -208,4 +231,4 @@
 
 Your documentation is now live at `/docs` for your primary domain.
 
-<Propagating />
+<Propagating />