<!-- LOVABLE:BEGIN -->
> [!IMPORTANT]
> This project is connected to [Lovable](https://lovable.dev). Avoid rewriting
> published git history — force pushing, or rebasing/amending/squashing commits
> that are already pushed — as it rewrites history on Lovable's side and the
> user will likely lose their project history.
>
> Commits you push to the connected branch sync back to Lovable and show up in
> the editor, so keep the branch in a working state.
<!-- LOVABLE:END -->

- Use a shared storefront module for catalog data and shopping state so the home and shop views stay consistent.
- Store downloaded reference media as Lovable Assets pointers to keep original product photography out of the repository.
- Shopping interactions are client-side session previews; do not imply checkout or payments are connected.
