Migrate docs to Astro/Starlight, move to freeoxide org, bump to 0.2.0 - #7
Merged
Conversation
Repository transferred hmziqrs/gpui-query -> freeoxide/gpui-query and the site is moving to gpui-query.freeoxide.com. Update all repo-URL and domain references (Cargo.toml homepage/repository, READMEs, CHANGELOG, web/ SEO metadata, robots.txt, llms.txt generator, sitemap host, Docusaurus config). Author attribution (authors, x.com/hmziqrs, hmziq.rs) left unchanged.
Also remove the "Introducing gpui-query" blog post and update navigation links to point to Changelog instead of About.
Disable Vite's autoSubfolderIndex to emit flat HTML files and prevent Cloudflare 308 redirects, which were causing Google to skip pages. Also exclude noindex landing previews from the sitemap, add the docs sitemap to robots.txt, and enhance meta descriptions across documentation and web routes.
Gates /v1–/v4 preview routes behind a feature flag and fixes two stale anchor links in the docs.
- Split blog frontmatter from MDX content imports - Lazy-load Firebase analytics - Self-host fonts via @fontsource-variable - Move build-time deps to devDependencies - Remove unused packages (cmdk, shadcn, etc.)
Replace the TanStack Start marketing/blog app and the separate Docusaurus docs site with a single static Astro build: Starlight owns docs at /docs/** (content nested under src/content/docs/docs/**, no base "/docs"); marketing, blog, legal, and 404 pages move to src/pages/**; docs MDX, the OG image, and the logo move from docs/ into web/. Build config: output static, outDir dist/client, trailingSlash "ignore" + build.format "directory" so both /docs/ and /docs resolve on Cloudflare Pages. The earlier never/file pairing forbade /docs/ entirely (hard 404 in dev AND prod). The post-build Pagefind index, llms.txt, and .md-alternate pipeline, plus the wrangler pages deploy step, are retained.
Blog post list now uses a two-column grid on medium screens.
- Release workflow now updates version in READMEs and installation docs alongside Cargo.toml - Website derives version and changelog from source files at build time instead of hardcoding them - Web deploy checks out the tagged commit for correct version in OG images and changelog page
- Add HTTP cache headers guide and document use_query_with_policy - Rewrite persistence guide for new Persister trait API - Add READMEs to gpui-query-http and gpui-query-persist crates - Update architecture docs from three to four layers - Re-export ReqwestBackend behind reqwest feature flag
The standalone docs/ package was removed in the Astro/Starlight migration (2ce4da8); docs now build inside web/ via the Astro content collection. The leftover "Install docs dependencies" step ran npm ci in a nonexistent docs/ directory, failing PR Checks in ~11s.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Consolidates the docs/web evolution that has accumulated on this branch since the original org-move PR (#6, closed).
What changed
Org & domain move
hmziqrs/gpui-query→freeoxide/gpui-query; domaingpui-query.hmziq.xyz→gpui-query.freeoxide.comacross Cargo.toml, READMEs, CHANGELOG, SEO metadata,robots.txt, sitemap/llms config.hmziqrs).Web migration: TanStack → Astro + Starlight
web/app from TSX routes to Astro + Starlight (27 pages, light+dark parity, green build).website/directory entirely.Site improvements
MobileNavandSearchDialog.Release
0.2.0; synced docs in CI.Notes
gpui-query.freeoxide.com+ 301 redirect off the old domain) tracked separately.