mirror of
https://github.com/supabase/supabase.git
synced 2026-05-06 17:00:27 -04:00
Alaister Young
cb34acd45c
The docs build had a fragile implicit dependency on www's filesystem (`../../../apps/www/public/llms`), flagged by the docs team in #44670. Rather than formalising that dependency with a shared package, this PR eliminates it entirely by making www the sole owner of llms content assembly. **How it works now:** `/llms/[slug]` handles all `/llms/*.txt` requests via a 3-step cascade: 1. Dynamic content — `pricing.txt` generated at request time from `shared-data` imports 2. Local file — product overviews read from `data/llms/` 3. Docs proxy — reference docs (guides, js, dart, etc.) fetched from the docs app No hardcoded slug lists, so adding new content just works. **What changed:** - `apps/docs/scripts/llms.ts` trimmed to only generate per-source reference files — www now owns `llms.txt`, `llms-full.txt`, and product overviews - Removed `generateLlmsPricing.mjs` build script — pricing generated dynamically from `shared-data` - Removed llms rewrites from `rewrites.js` — routes handle everything with consistent `Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400` - Product overview `.txt` files moved from `public/llms/` → `data/llms/` so all requests go through routes for consistent caching **Docs team concerns from GROWTH-773:** | Concern | Resolution | |---------|-----------| | Docs build depends on www files at a fragile relative path | Path removed — docs no longer reads from www | | www restructuring breaks docs with no obvious connection | Eliminated — no cross-app filesystem dependency | | No build order enforcement between www and docs | Not needed — docs doesn't depend on www's build output | ## To test - `curl <preview>/llms.txt` — markdown index with doc + product overview links - `curl <preview>/llms-full.txt` — combined product overviews + docs content - `curl <preview>/llms/pricing.txt` — dynamically generated pricing tables - `curl <preview>/llms/auth.txt` — product overview from local file - `curl <preview>/llms/guides.txt` — proxied from docs app - `curl <preview>/llms/nonexistent.txt` — 404 - Verify `Cache-Control` header on all responses --------- Co-authored-by: Alaister Young <10985857+alaister@users.noreply.github.com>
41 lines
599 B
Plaintext
41 lines
599 B
Plaintext
# Dependencies
|
|
/node_modules
|
|
|
|
# Production
|
|
/build
|
|
|
|
# Generated files
|
|
.cache-loader
|
|
|
|
# Misc
|
|
.DS_Store
|
|
.env.local
|
|
.env.development.local
|
|
.env.test.local
|
|
.env.staging.local
|
|
.env.production.local
|
|
*.swp
|
|
|
|
npm-debug.log*
|
|
yarn-debug.log*
|
|
yarn-error.log*
|
|
|
|
**/__generated__/**/*
|
|
**/*/generated/**/*
|
|
!**/*/generated/.gitkeep
|
|
!**/*/generated/**/.gitkeep
|
|
|
|
# Sitemap
|
|
public/sitemap.xml
|
|
# Per-source llms files (generated by build:llms, served by www)
|
|
public/llms/
|
|
# Generated guide markdown files
|
|
public/docs/
|
|
public/docs.tar.gz
|
|
|
|
# Copied examples folder
|
|
/examples/
|
|
|
|
# Sentry Config File
|
|
.env.sentry-build-plugin
|