feat(docs): flare-dispatch.fractalbox.dev opens on a product page; the docs move under /docs/ - #160
Merged
Merged
Conversation
…e docs move under /docs/ / is a product page (cost model, positioning, code, platform) and /benchmarks/ lists the modeled per-run cost, both plain Astro pages outside Starlight. The Starlight docs serve under /docs/, and public/_redirects 301s the root-level docs paths to them.
…t engine at build time apps/docs/src/data/benchmarks.ts holds one workload profile per run and prices it with @fractalboxdev/flare-dispatch-core/cost, so the page and the landing cost card read the same rate card that meters real executions. There is no committed JSON to regenerate and no mirrored rate card for cost.test.ts to guard.
There was a problem hiding this comment.
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
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.
flare-dispatch.fractalbox.devopens on a product page again: what FlareDispatch is, what it costs against GitHub-hosted runners, and where to start. The documentation lives one click away at/docs/, and every docs link already in circulation still resolves.Problem & Insight
The docs site took over the root domain, so
/showed Starlight's docs front page and the product page had nowhere to live. Starlight owns every route in its content collection but leavessrc/pages/alone, so a standalone Astro page can hold/while Starlight serves the docs from adocs/subdirectory of the same collection. It stays one build, one Worker, one domain.Take
/(src/pages/index.astro): hero, billing timeline and cost card, positioning table, a workflow-step / typed-run code sample, platform capabilities, design principles. Every platform claim matches a run or module at HEAD (pr-review,self-heal-pr,packages/bedrock-sigv4,admission-summary.ts,product-demo,ci-triage-pr).standard-2(≈ $0.004), so the 14–52× ratio is computed, not written in by hand./benchmarks/:src/data/benchmarks.tsholds a workload profile per run and prices it at build time through@fractalboxdev/flare-dispatch-core/cost, the engine that meters real executions. A rate change incost.tsreprices the page on the next build. The committedbenchmarks.jsonand thecost.test.tscheck that guarded its hand-copied rate card are gone, since nothing is copied any more. The page labels every figure as modeled, not metered./docs/…: the content symlinks move tosrc/content/docs/docs/, and the sidebar slugs,/llms.txtand/llms-full.txtfollow them. The overview drops thesplashtemplate for a normal doc page.public/_redirects301s/actions/*,/runs/,/substrate/*,/reference/*and/design/*to/docs/…. Verified underwrangler dev.starlight-themekey, so the light/dark choice carries across both halves of the site.The landing page has its own stylesheet (
landing.css) instead of sharing Starlight's, because Starlight's reset and layout would fight the page's grid. The palette tokens matchbrand.css.Key actions
astro buildgreen;pnpm test2371 passed, all internal links valid;astro check0 errors; no horizontal scroll at 390 pxcheck,worker-deploy,improve-pr,self-heal-pr,triage-issues,triage-prs,org-spec-auditanddemo-reel, which are registered but not yet on/benchmarks/