Files
hemx/examples/saas
slhx agent 107111052d docs(recipes): add observability flags boundary
Document provider-explicit observability, feature flag, A/B, and killswitch boundaries for hemx apps. The recipe keeps metrics providers and rollout controls in app/platform code while handlers return generated effects and the tiny runtime stays provider-free.

req: laws/002

req: laws/004

req: runtime/003

req: runtime/004

req: failure/004

req: examples/001

req: test/001
2026-06-05 09:52:59 +02:00
..

hemx SaaS tutorial skeleton

This is the compile-tested skeleton for the v1 production-shaped tutorial app. It is intentionally provider-light: auth/session, CSRF, persistence, deploy, metrics, and islands are explicit app boundaries, not hemx core services. req: examples/001 req: auth/001

What it proves today:

  • typed form/newtype inputs for project creation
  • auth/session context passed through normal Rust state
  • CSRF-safe mutation checked before persistence
  • local in-memory persistence adapter instead of a vendored SQL/auth provider
  • generated form, slot, keyed row, page-swap, and live-status commands
  • page shell with plain CSS and one explicit metrics island script
  • compile-time surface generation plus interaction tests

For provider-explicit boundaries, see ../../docs/recipes/sqlx-persistence.md, ../../docs/recipes/auth-session-csrf.md, ../../docs/recipes/observability-flags.md, and ../../docs/recipes/deploy-versioning.md.

What it deliberately does not claim yet:

  • a checked-in SQLx migration crate or database pool
  • production cookie/session middleware
  • a deploy target, flags, analytics, billing, or offline sync
  • browser automation for the metrics island

Run:

cargo run -p hemx-saas-example
cargo test -p hemx-saas-example