Deployment

Per-Shop Architecture

LamaShopi uses a template deployment model: each merchant gets their own app instance with a dedicated database. This is not a multi-tenant SaaS — it's a codebase-as-template approach.

Benefits

• Isolation — each shop's data is completely separate
• Customization — feature flags and configuration are per-shop
• Independence — one shop's issues don't affect others
• Simplicity — no multi-tenant complexity in the codebase

Trade-offs

• Each deployment needs its own hosting, database, and Redis instance
• Updates must be rolled out to each deployment individually (or automated via CI/CD)

What Gets Deployed

Theme

The theme is deployed to Shopify via Shopify CLI:

shopify theme push

Only build outputs are deployed (.shopifyignore excludes source files).

Companion App

The Laravel app is deployed to your hosting provider. Key requirements:

• PHP 8.3+ runtime
• MySQL 8.0+ database
• Redis instance
• Queue worker(s)
• Scheduler (cron)
• SSL certificate (required for Shopify App Proxy)

Next Steps

• Production — Queue workers, scheduler, monitoring
• New Shop Onboarding — Step-by-step for adding a new merchant