# Agent / editor notes

This repo is the **DressX Shopify PDP try-on popup** (widget JS + local harness).

Sibling project **`dx-tryon-shopify-app`**: embedded app, theme extension (Try-on button), Django API/static. Live PDP loader is there (`backend/webapp/static/assets/js/loader_shopifyapp_ngrok.js`), not here. There is no `template/` copy of this widget in the Shopify app.

1. Read **[README.md](./README.md)** for architecture, modules, state machine, and host globals.
2. Cursor rules in **[`.cursor/rules/`](./.cursor/rules/)** apply automatically by file; start with `project-overview`, then `host-integration` for loaders/globals.
3. Default edit file: **`try-on_shopifyapp_combined_test.js`**. Keep the monolith for parity only.
4. Local check: `python3 serve.py` → http://127.0.0.1:8123/local_test.html
5. Live PDP: serve + ngrok this repo; update `COMBINED_JS_URL` in the Shopify app’s Django `loader_shopifyapp_ngrok.js` when the tunnel URL changes.