Introduction

LamaShopi is a reusable foundation for Shopify commerce projects, split into two codebases that work together:

Layer	Repository	Stack
Storefront theme	lamashopi	Shopify Liquid / OS 2.0, Vite, Tailwind, GSAP, Lenis, Swiper
Companion app	app.lamashopi	Laravel 13, Filament 5, Horizon, Redis, Pest

Why Two Codebases?

Shopify's platform leaves certain core functionality limited or missing: stock visibility per location, wishlists that work for both anonymous and logged-in shoppers, reliable back-in-stock flows with email and privacy compliance. Rather than installing multiple third-party apps (each with its own subscription, integration risk, and styling mismatches), a single companion app provides control, a unified architecture, and predictable costs.

The theme handles what visitors see: pages, navigation, products, and checkout via Shopify. The companion app runs alongside the shop — storing data, sending emails, communicating securely with Shopify's API, and providing admin screens for the team.

How They Connect

• The theme calls the companion app through Shopify's App Proxy (requests are HMAC-verified by Shopify).
• The companion app talks to Shopify's Admin API via GraphQL (with automatic throttle/retry) and REST.
• Shopify sends webhooks to the companion app for inventory updates and GDPR compliance events.

For the Agency

This setup means one reusable foundation for multiple clients:

1. Duplicate both repos for a new shop
2. Configure environment variables and feature flags
3. Deploy — each shop gets its own app instance and database
4. Connect the theme to the proxy endpoints

No need to start from scratch. Features can be toggled on/off per project, and both codebases can be extended independently without breaking each other.

What's Included

Theme Boilerplate

• Component-based architecture with a custom Vite build pipeline
• Tailwind design system with tokens for colors, typography, spacing, and grid
• Dynamic JS module loading via data-component attributes
• GSAP animations, Lenis smooth scroll, Swiper carousels
• Biome linting and formatting

Companion App

• Inventory per location — cached, webhook-invalidated stock data
• Wishlists — anonymous and authenticated, with merge on login
• Out-of-stock notifications — double opt-in email flow, optional Klaviyo integration
• Bundles — configurable product bundles with automatic Shopify discounts
• Store locator — physical stores with geocoding and category filtering
• Free shipping bar — threshold data from Shopify shipping profiles
• Filament admin — agency panel (full access) and shop-owner panel (limited)
• GDPR compliance — webhook handlers and scheduled data purge
• Observability — Horizon, Spatie Health, Flare, Log Viewer