Skip to content

SEO: 50 new pages on cross-OS business-logic portability - #80

Merged
enricopiovesan merged 8 commits into
mainfrom
seo/cross-os-business-logic-content
Sep 11, 2026
Merged

SEO: 50 new pages on cross-OS business-logic portability#80
enricopiovesan merged 8 commits into
mainfrom
seo/cross-os-business-logic-content

Conversation

@enricopiovesan

Copy link
Copy Markdown
Collaborator

Summary

Targets the query cluster "what framework can I use to create apps to deploy in any OS without changing any business logic" and its close permutations, with an SEO/content strategy that leans into this project's existing honesty culture rather than overselling "any OS" the way most cross-platform marketing does.

  • 1 flagship question page (questions/what-framework-runs-business-logic-on-any-os.html) with FAQPage schema covering the exact phrase and close variants
  • 41 more question pages rounding out the cluster: per-OS status, mobile status (honest about Android/.NET in-progress, iOS blocked), the device-independent execution model, WASM/sandbox education, honest comparisons against Flutter/Electron/Tauri/.NET MAUI/Docker/shared-Rust-libraries/raw WASM runtimes, migration, versioning, monorepo usage, testing guidance, and an explicit "when NOT to use Traverse" page
  • 2 comparison pages: compare/vs-cross-platform-frameworks.html (Traverse vs Flutter/Electron/Tauri/React Native/.NET MAUI, with a real Tauri + traverse-embedder code example) and compare/vs-wasm-runtimes.html (Traverse vs Wasmtime/WasmEdge/Wasmer — positions Traverse as a governance layer built on Wasmtime, not a competing runtime)
  • 5 blog posts in the existing first-person voice, including a direct narrative answer to "does this work on any OS," an industry-critique piece on what "cross-platform" actually means across Flutter/Electron/Tauri/RN/PWAs, and a piece extending the same honesty standard to the v1.0 roadmap gates
  • 1 hands-on tutorial guide (docs/guides/cross-os-capability.html) walking through building, inspecting, and running the shipped expedition bundle natively and in-browser, verifying identical behavior from the trace artifact

All content is grounded in the current, real platform matrix (native Linux/macOS/Windows + browser shipped; Android/.NET in progress, unreleased; iOS blocked on the WASM engine ecosystem) rather than a rounded-up version of it — matching the standard already set by /platforms.html and the /discover truthfulness tests.

Also fixes a pre-existing package-lock.json / package.json version mismatch (traverse-embedder-web) that was leaving node_modules incomplete and breaking npm run build on a clean checkout.

All new pages are wired into questions/index.astro, compare/index.astro, blog/index.astro, docs/guides/index.astro, and DocsSidebar.astro — nothing is orphaned. Sitemap regenerates automatically at build time (142 URLs total, up from 92).

Test plan

  • npm run build succeeds with no errors (142 pages)
  • Automated internal-link check across every new file — zero broken links introduced (2 pre-existing broken /use-cases.html links found in untouched files, left as-is and out of scope)
  • Visually verified the flagship question page, the cross-platform-frameworks comparison, one blog post, and the tutorial guide in a browser — all match the site's existing dark-theme design system
  • Reviewer sanity-check on tone/voice consistency across the batch, given the volume

🤖 Generated with Claude Code

enricopiovesan and others added 8 commits September 10, 2026 22:01
Targets "what framework lets me write business logic once and run it
on any OS" and close permutations. Answers honestly against the
current platform matrix (native Linux/macOS/Windows + browser
shipped; Android/.NET in progress; iOS blocked) rather than
overselling "any OS" the way most cross-platform marketing does.

- New question page with FAQPage schema covering the query cluster
- New compare/vs-cross-platform-frameworks.astro distinguishing
  Traverse (business-logic layer) from Flutter/Electron/Tauri/MAUI
  (UI layer), including a Tauri + traverse-embedder code example
- Wired into questions/ and compare/ hub indexes
- package-lock.json: npm install resolved a lockfile/package.json
  version mismatch that had left traverse-embedder-web uninstalled,
  breaking `npm run build` on a clean checkout

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Extends the "any OS, one binary" question cluster: honest per-OS
status pages (does-traverse-support-windows-macos-and-linux,
what-operating-systems-does-traverse-support, can-traverse-build-mobile-apps),
the device-independent execution model, avoiding logic duplication
across platforms, and how Traverse differs from Flutter/Electron/Tauri
specifically. All cross-link to platforms.html and the new comparison
page rather than restating the platform matrix inconsistently.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
First-person posts in the established blog voice, all answering
variants of "does this work on any OS" and building topical authority
around the honest platform matrix instead of an oversold one:

- "Does this work on any OS?" — the direct, narrative answer
- Same binary, three operating systems — the native execution mechanics
- Why "cross-platform" rarely means what it sounds like — industry
  framing for Flutter/Electron/Tauri/React Native/PWA vs the logic layer

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
… honest platform comparisons

Rounds out the "any OS / one binary" cluster with generic WASM
education (sandbox, is-webassembly-cross-platform), honest comparisons
against adjacent approaches (shared Rust library, Docker, .NET MAUI,
Electron), migration and packaging mechanics, and direct answers to
"what happens if my platform isn't supported yet." Includes one page
that names an explicit unmet v1.0 gate (five-platform CI stress
matrix) rather than implying cross-OS parity is already fully proven.

All wired into questions/index.astro; 125 pages build cleanly.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Covers non-Rust team consumption, performance overhead honesty,
explicit anti-persona guidance (when NOT to use Traverse), a
buyer's-guide page for evaluating cross-platform approaches generally,
cross-OS behavioral consistency, versioning across platforms, and
monorepo usage. 132 pages build cleanly.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
compare/vs-wasm-runtimes.astro positions Traverse correctly relative
to Wasmtime/WasmEdge/Wasmer: built on top of Wasmtime as a governance
layer, not a competing execution engine. The two new posts extend the
honesty narrative to versioning claims generally (the v1.0 gates) and
to the shared-library alternative specifically. 135 pages build
cleanly.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
docs/guides/cross-os-capability.astro walks through building the
shipped expedition bundle, inspecting it, running it through the
native executor, loading the identical binary in a browser, and
confirming the match from the trace artifact rather than by eye.
Wired into the guides index and DocsSidebar. 136 pages build cleanly.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Registry bundle portability, PWA vs Traverse positioning, AI-agent
consistency across OS, pre-ship testing guidance, minimum viable
capability size, and a SaaS-specific use case. 142 pages build
cleanly with no broken internal links introduced.

This completes the "what framework lets me write business logic once
and run it on any OS" content cluster: 1 flagship question page + 44
supporting question pages, 3 new compare pages, 5 blog posts, and 1
hands-on tutorial guide — 50 new pages total across this branch.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@enricopiovesan
enricopiovesan merged commit 060ac5d into main Sep 11, 2026
5 checks passed
@enricopiovesan
enricopiovesan deleted the seo/cross-os-business-logic-content branch September 11, 2026 04:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant