How to work with SHOPin
How to extend the SHOPin storefront accelerator: repository layout, storefront and BFF boundaries, auth, validation, and the workflow checks that keep the monorepo consistent.
You can start from UI, contracts, or data access—what matters is wiring types, BFF routes, and presentation consistently. Shared types live in core/contracts; keep that package authoritative for cross-layer shapes.
Sections
- General workflow rules — Pre-commit checks, TypeScript, tests, lint, format.
- Building blocks — Feature layout, components, icons, translations, config, contracts.
- BFF & data — BFF usage, data sources, integrations.
- Cart & authentication — Cart, anonymous sessions, authentication.
- Validation & resilience — Validation, logging, error handling.
- AI Skills — Optional agent skills that add components, BFF modules, integrations, and features.
Use the Documentation sidebar to open nested pages. For cache, CDN, SEO, and workspace boundaries, see Advanced topics.