Storefront Runner

A world-shareable, multi-tenant renderer runtime for the Token of Trust storefront. It serves N tenants (or differently-named variants of one tenant) at path-prefix URLs — the same thing astro dev does for the full platform — with the control-plane services (content authoring, compliance, and the publish/deploy control plane) kept private and physically carved out.

Run

pnpm install
pnpm dev            # astro dev on http://localhost:4321

Tenants resolve by Host header first, then by a /<domain>/… path prefix (DNS-free, for localhost). Try:

• http://localhost:4321/ (the neutral "home" default)
• http://localhost:4321/sample-store.example/ (generic sample store — shows the 21+ compliance gate)

Your OWN tenant is served by the tot dev loop, which grafts your checkout into tenants/<id>/ at runtime — no bundled merchants ship with the runner.

Add a tenant

Adding a tenant is a one-object edit in apps/storefront/src/config/tenants.ts (see SAMPLE_TENANT), plus a tenants/<id>/ directory for its content/theme/public assets.

IP boundary

This distributable depends only on @tot/public-runtime (the renderer-safe model). The private control-plane package is absent, so a control-plane import cannot resolve here.

License

Source-available, local-development only (see LICENSE). You may run, build, and modify this for Local Development. Any other use — deploying, hosting, or serving it to third parties, or any production/commercial use — requires the prior written permission of Token of Trust, Inc.