Everyday · architecture profile
Plans With You
Calendar protection that plans a cancellation. An Astro and React app on Cloudflare with magic-link accounts, a relational store and artifact storage.
How it is built.
Plans With You is a real account product: magic-link sign-in, a membership service, a D1 database and R2 artifact storage. The site still serves, but the reviewed lifecycle is retired, so its architecture is history rather than a current product promise.
- Stack
- Astro 7.2, React 19.2, TypeScript, Tailwind 4, Three UIEvidence: package.json; astro.config.mjs
- Runtime
- Cloudflare Worker `social-club` through the Astro Cloudflare adapterEvidence: wrangler.jsonc
- Storage
- D1 `social-club`, R2 `social-club-artifacts`, KV `SESSION`Evidence: wrangler.jsonc
- Identity
- Magic-link email sign-in with a `society_session` cookie backed by D1 sessions, an onboarding/member state machine and dedicated sign-in and waitlist rate limiters.Evidence: src/services/magic-link.ts; src/lib/portal-auth.ts; wrangler.jsonc rate limiters
- Delivery
- Cloudflare Worker `social-club` through the Astro adapter at club.loftwah.com; no cron configuredEvidence: wrangler.jsonc; mise.toml deploy-production
- Integrations
- Resend for outbound email and the signed inbound email webhook; a MiniMax text/image adapter; a Stripe billing seam that is disabled/fake by default.Evidence: src/adapters/resend-real.ts; src/adapters/minimax-real.ts; src/services/billing-service.ts
The shape of the system.
- Web appAstro pages and React islands carry the product story and signed-in views.Evidence: src
- AuthMagic links are minted and verified server-side; the session lives in KV.Evidence: src/services/magic-link.ts; wrangler.jsonc kv
- MembershipMembership rules are a service, not a flag copied across pages.Evidence: src/services/membership-service.ts
- ArtifactsR2 stores generated artifacts separately from relational rows.Evidence: wrangler.jsonc r2_buckets
Engineering decisions worth knowing.
- Magic links over passwords
A product used occasionally does not need another password. Email possession is the recovery path, and the rate limiter is the abuse boundary.
- Account deletion is a service
Deleting an account touches identity, membership and stored artifacts; keeping that in one service is what makes the promise testable.
- Billing is a seam, not a switch
A Stripe adapter exists but is disabled by default. That lets the membership flow be built and reviewed without pretending a payment path is live.
What it connects to.
No verified cross-project runtime relationship. Plans With You is reachable from Woodhouse as a published record, and its product links are ordinary navigable links.
Authoritative public sources
What this review does not know.
- The retired product's data retention and deletion completion were not audited in this review.
- Stripe billing was disabled in the reviewed source; no real charge, refund or tax path is claimed.
- Commented-out queue bindings in the configuration were not treated as active infrastructure.
- The inbound email webhook signature path was not exercised.