Skip to content

docs: add root index.html fallback so SWA deploy validation passes#1687

Merged
mohnjiles merged 1 commit into
mainfrom
docs-root-index
Jul 14, 2026
Merged

docs: add root index.html fallback so SWA deploy validation passes#1687
mohnjiles merged 1 commit into
mainfrom
docs-root-index

Conversation

@mohnjiles

Copy link
Copy Markdown
Contributor

What

Fixes the failed first deploy of docs.lykos.ai (run): Azure/static-web-apps-deploy requires a default file (index.html) at the app root, and the /stability-matrix/ URL prefix (#1676) left the dist root with only assets + the prefixed tree.

  • Adds docs/public/index.html — copied verbatim to the dist root by VitePress, satisfying the deploy validation.
  • The page is a meta-refresh → /stability-matrix/ with a canonical link, acting as the redirect on hosts without SWA routing (bonus: bare localhost:4173/ now works in local preview). On Azure the existing "/" 302 route in staticwebapp.config.json is evaluated before static content, so production behavior is unchanged.
  • Gets replaced by a real product landing page when the site goes multi-product.

Verified: vitepress build clean, dist/index.html + dist/staticwebapp.config.json both present, root redirect exercised in local preview.

Merging this (docs/** push to main) triggers the deploy workflow again — no manual re-run needed.

🤖 Generated with Claude Code

The static-web-apps-deploy action requires a default file (index.html)
at the app root, and the /stability-matrix/ prefix left the dist root
without one, failing the first deploy. This page satisfies the check
and meta-refreshes to /stability-matrix/ as a fallback for hosts
without SWA routing (e.g. local preview); on Azure the "/" 302 route
still takes precedence. Replaced by a real landing page when the site
goes multi-product.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a root landing fallback page (docs/public/index.html) that redirects users to the Stability Matrix documentation. This file satisfies Azure Static Web Apps deployment requirements and handles local preview redirects. There are no review comments, and I have no feedback to provide.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

@mohnjiles mohnjiles enabled auto-merge July 14, 2026 04:10
@mohnjiles mohnjiles merged commit faca7f4 into main Jul 14, 2026
5 checks passed
@mohnjiles mohnjiles deleted the docs-root-index branch July 14, 2026 04:11
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 14, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants