Skip to content

docs: surface SSG support across READMEs#17

Merged
jonlaing merged 2 commits into
mainfrom
docs/ssg-visibility
Jun 25, 2026
Merged

docs: surface SSG support across READMEs#17
jonlaing merged 2 commits into
mainfrom
docs/ssg-visibility

Conversation

@jonlaing

Copy link
Copy Markdown
Owner

Summary

  • Top-level README.md gains a Rendering Modes section near the top (SPA/SSR/SSG comparison) and a dedicated Static Site Generation section with a Route.static example
  • @effex/platform README is reframed for both SSR and SSG with an explicit decision table, plus a full SSG Quick Start parallel to the existing SSR Quick Start
  • @effex/create-effex README documents the SSG template, --ssg flag, project structure, and build commands
  • buildStaticSite and BuildStaticSiteOptions added to the platform API reference

No code changes — pure documentation. SSG functionality already existed end-to-end (template, vite-plugin mode, Platform.buildStaticSite); this just makes it discoverable.

Test plan

  • Render each modified README locally (or in GitHub's preview) and confirm headings/tables render correctly
  • Click through internal links to verify they resolve
  • Spot-check the code samples in the new SSG sections compile in a fresh SSG project

Closes #16

🤖 Generated with Claude Code

- Top-level README: add Rendering Modes section (SPA/SSR/SSG comparison),
  add Static Site Generation section with Route.static example and
  hosting note. Update Quick Start to mention --ssg flag.
- @effex/platform README: introduce SSR + SSG framing, add SSR vs. SSG
  decision table, add SSG Quick Start with full Route.static, entry,
  vite.config, output structure, and hydration examples. Add
  buildStaticSite + BuildStaticSiteOptions to API reference.
- @effex/create-effex README: document SSG template, --ssg flag,
  project structure, and build commands.

Closes #16

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 21, 2026

Copy link
Copy Markdown

Deploying effex with  Cloudflare Pages  Cloudflare Pages

Latest commit: d153d3a
Status: ✅  Deploy successful!
Preview URL: https://15719c56.effex.pages.dev
Branch Preview URL: https://docs-ssg-visibility.effex.pages.dev

View logs

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 21, 2026

Copy link
Copy Markdown

Deploying effex-api with  Cloudflare Pages  Cloudflare Pages

Latest commit: d153d3a
Status: ✅  Deploy successful!
Preview URL: https://05a78fa6.effex-api.pages.dev
Branch Preview URL: https://docs-ssg-visibility.effex-api.pages.dev

View logs

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@jonlaing jonlaing merged commit 3af9c6e into main Jun 25, 2026
4 checks passed
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.

Document SSG support across READMEs

1 participant