Welcome to NShop

NShop is a multi-tenant ecommerce platform. One install runs many branded storefronts — each with its own catalog, orders, branding, payouts, team, and domain. Customers are shared across tenants (one account everywhere), while everything else is isolated.

This documentation covers every feature the platform ships with, split by who uses it.

Pick your path

• Shopping guide — for customers: browsing, cart, checkout, orders, reviews, account, language.
• Admin guide — for tenant admins: catalog, variants, orders, kitchen & sold-out (restaurants), refunds, coupons, customers, team, branding, payments, shipping, analytics.
• AI features — the storefront chat, the hidden ADK + AG-UI shopping agent, AI image generation, and growth insights.
• Multi-tenancy — tenants, subdomains, custom domains, roles, isolation, superadmin.
• Reference — glossary and FAQ.

What makes NShop different

1. Multi-tenant from day one. Not a single-store app retrofitted; tenant isolation runs through routing, auth claims, Firestore rules, and Stripe Connect.
2. Two AI surfaces. A storefront chat for casual help, and a hidden ADK + AG-UI agent with authenticated tools that can really do things — add to cart, look up orders, remember preferences.
3. Server-side money math. Prices, discounts, shipping, and VAT are always recomputed server-side at checkout. The cart can't lie to Stripe.
4. Variants done right. Stock, prices, and reservations branch on variantId end-to-end — the cart, checkout, webhook, and the scheduled restock job all stay aligned.
5. Restaurant-ready. Dishes, modifier groups, sold-out toggles, kitchen board, and separate food order timelines — alongside classic shop stock & shipping.
6. EU-first. GDPR export and erase, locale-aware emails, NL postcode lookups, address autocomplete in 20+ countries, and EU region pinning for data and AI calls.