Architecture
The three layers.
PETVITY is a static-site-with-progressive-integrations architecture. Marketing pages are pure HTML/CSS. Auth, products, payments, calendar bookings, email — all live in lazy-loaded modules behind feature flags. Each integration can be activated independently; none is required for the site to work.
Layer 1 · Static
- HTML / CSS / SVG
- 35 top-level pages
- 16 blog articles
- 3 protocols
- 7 Care Partner course files
Always works. Zero dependencies.
Layer 2 · Drop-ins
- petvity-auth.js · client-side auth
- integrations.js · feature-flagged SDKs
- analytics.js · usage tracking
- i18n.js · 5 languages scaffolded
Each enabled via one flag. Falls back gracefully.
Layer 3 · External
- Shopify · products + checkout
- Stripe · subscriptions + course buys
- Supabase · auth + DB at scale
- Klaviyo · email
- Cal.com · bookings
Activate one at a time. Each has a setup guide.
The activation order.
If you're spinning the company up to revenue, the recommended sequence:
For sales (CHF in)
- Activate Shopify (90 min · see SHOPIFY_SETUP.md). Products live.
- Activate Stripe Checkout for memberships (60 min). Memberships live.
- Activate Klaviyo or Resend for transactional email (30 min).
- Connect Cal.com for vet office hours / partner intake (15 min).
For scale (members > 100)
- Activate Supabase (30 min · see AUTH_SETUP.md). Cross-device login.
- Activate Sentry for error tracking (10 min).
- Activate Mux or Vimeo for Quest/Academy video (1 hour).
- Activate Stripe Connect for partner payouts (2 hours).