Add standalone Maple Local landing + docs site (apps/local-landing)#197
Add standalone Maple Local landing + docs site (apps/local-landing)#197Makisuo wants to merge 4 commits into
Conversation
New Astro app marketing Maple Local as an independent local OpenTelemetry
tool on its own apex domain (maplelocal.dev), with full docs (install,
quickstart, sending data for Node/Python/Go, CLI reference, offline mode,
data & storage, updating). Reuses the maple.dev branding and the local/live
showcase components; adds a comparison table vs other local OTel setups and
an FAQ.
Deploy wiring: new local-landing worker (Worker + Assets, same pattern as
apps/landing) registered in the root alchemy run; MapleDomains gains
localLanding, commented out until the maplelocal.dev zone is live (worker
falls back to workers.dev until then — see apps/local-landing/README.md).
maple.dev hand-off: /local CTAs now point at maplelocal.dev, the old Local
Mode docs are drafted out of routes/search/sitemap, and the landing worker
301s /docs/local-mode{,/cli-reference} to the new site.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MJHpLvAF4qFh7dktKm1i7C
Mirror the apps/landing convention (ignoreWorkspaces) for the new Astro app, delete the unused LocalFlow/LocalHero component copies, prune unused deps (clsx, class-variance-authority, tailwind-merge), and fix a stale .gitignore comment flagged in review. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MJHpLvAF4qFh7dktKm1i7C
|
Addressed the review in 799a755: fixed the stale On the installer-URL question: keeping Generated by Claude Code |
The health-dot class picked svc-map-health--info for both non-warn branches, so sub-1% error rates were indistinguishable from 0%. Map the three existing classes to real tiers (>1 error, >0.3 warn, else info) in both the new site's copy and the apps/landing original it was copied from. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MJHpLvAF4qFh7dktKm1i7C
There was a problem hiding this comment.
ℹ️ No critical issues — one minor cleanup nit in the body.
Reviewed changes — the two commits since the prior pullfrog review (a338b32): a knip-CI fix that prunes dead code from the new apps/local-landing app, and a fix to the service-map health-dot color tiers.
- knip CI fix (
799a755) — addedapps/local-landingtoknip.jsonignoreWorkspaces(mirroringapps/landing), deleted the unused component copiesLocalFlow.astroandLocalHero.astro, pruned unused depsclsx/class-variance-authority/tailwind-mergefrompackage.jsonandbun.lock, and fixed the stale.gitignorecomment (sync:install→sync:cli) flagged in the prior review. - service-map health tiers (
3842dfe) — replaced a dead ternary branch inLiveServiceMap.astro(bothapps/local-landingandapps/landing) where--errorwas never emitted and two branches both returned--info; nowerrNum > 1 → --error,> 0.3 → --warn, else--info.
Both commits are correct and well-scoped. The pruned deps are removed consistently from package.json and bun.lock; the deleted LocalFlow/LocalHero copies have no remaining imports; all three svc-map-health--* classes exist in global.css; and the new thresholds map sensibly onto the mock service data (pricing err=2.4 → error, payments err=0.5 → warn). The prior review's .gitignore inline nit is resolved.
ℹ️ Stale doc-comments reference the components deleted in 799a755
Deleting LocalFlow.astro and LocalHero.astro left two sibling files describing them as still present. The comments read as "a page-only elevation of the docs-tuned LocalFlow.astro (left untouched...)" and "distinct from the docs-tuned LocalHero.astro" — both now point at files that no longer exist. Purely cosmetic (no runtime impact), but a future reader following the reference will hit a dead end.
Technical details
# Stale doc-comments reference deleted components
## Affected sites
- `apps/local-landing/src/components/local/LocalLoopback.astro:5` — comment calls it "a page-only elevation of the docs-tuned `LocalFlow.astro` (left untouched...)"; `LocalFlow.astro` was deleted in `799a755`. (`LocalLoopback.astro:60` also mentions "LocalFlow" in a CSS comment.)
- `apps/local-landing/src/components/local/LocalProductHero.astro:5` — comment says "Distinct from the docs-tuned `LocalHero.astro`..."; `LocalHero.astro` was deleted in `799a755`.
- `apps/local-landing/src/components/local/InstallTabs.astro:8` — comment "Mirrors LocalHero's terminal frame + copy button" also references the deleted file.
## Required outcome
- Reword these comments so they no longer imply the deleted files still exist (e.g. drop the cross-reference or describe the pattern inline).@v0 or keep the SHA fresh with Dependabot | Fix it ➔ | View workflow run | Using Claude Opus | 𝕏
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MJHpLvAF4qFh7dktKm1i7C

What
A new standalone Astro site (
apps/local-landing) that markets Maple Local as an independent local OpenTelemetry tool on its own apex domain (maplelocal.dev), with full docs — separate from maple.dev, while cross-linking back to Maple Cloud.New site
/localpage (hero with streamingmaple startbanner, value props, loopback data-flow, live trace/logs/service-map showcases, CLI grid), plus two new sections: an honest comparison table (Jaeger all-in-one, SigNoz, otel-tui, Grafana LGTM) and an FAQ (offline mode, data locality, relation to Maple Cloud, Windows).docs/local-mode.md+ the old Local Mode docs: Getting Started (install, quickstart), Sending Data (OTLP overview, Node.js, Python, Go), Reference (CLI), Operations (offline mode, data & storage, updating/uninstalling).apps/landingwith the SDK-selector dimension stripped (sidebar, mobile nav, prev/next, TOC, Fuse.js ⌘K search, search-index endpoint). No i18n, no blog.global.csscopy,@maple/uishared), serves/cli/install+/cli/uninstalllike maple.dev.Deploy wiring
packages/infra:MapleDomains.localLandingadded; the prd/stg domain entries are commented out until the maplelocal.dev zone is live in Cloudflare — until then the worker deploys on workers.dev (same fallback as PR previews). Manual zone setup steps are inapps/local-landing/README.md.apps/local-landing/alchemy.run.ts(Worker + Assets, same pattern as landing) registered in the rootalchemy.run.ts; no CI workflow changes needed.maple.dev hand-off
/localpage CTAs now point at maplelocal.dev.draft: true(drops them from routes, sidebar, search index, and sitemap) and the "Local Mode" group removed from the docs nav./docs/local-modeand/docs/local-mode/cli-referenceto the new site's equivalents.Verification
bun run --cwd apps/local-landing build— 13 pages, sitemap, search index, 404,/cli/installall indist/.astro previewsmoke test:/,/docs, quickstart, CLI reference, and search-index all 200.apps/landingrebuilds clean: old local-mode pages gone from routes/search-index/sitemap,/locallinks to the new site.bun turbo typecheck --filter=@maple/infrapasses. (@maple/query-enginetypecheck fails on the base branch for unrelated reasons — untouched here.astro checkreports the same pre-existing@maple/uiresolution warnings asapps/landing; neither app runs it in CI.)🤖 Generated with Claude Code
https://claude.ai/code/session_01MJHpLvAF4qFh7dktKm1i7C
Generated by Claude Code