Runbooks
Symptom-led diagnosis for the Beauty Affairs AU theme.
Runbooks
Start from the symptom.
| Symptom | Runbook |
|---|---|
npm run dev fails, or the preview will not load | Dev server will not start |
| A feature does nothing and the console shows a 404 for an asset | Assets out of sync |
A change to src/ has no effect on the storefront | Assets out of sync |
| Cart total, progress bar or free gift is wrong | Cart total or gift is wrong |
400 no valid id or line parameter in the console | Cart total or gift is wrong |
| Book Now does nothing, or the calendar is empty | Booking calendar will not open |
| Two popups at once, or a popup at the wrong moment | Popup shows at the wrong time |
| The homepage reverted to an older layout | Branches and theme sync |
Before you start
Turn on debug logging. It is off by default, so the console stays empty even when the theme is logging.
https://beautyaffairs.com.au/?ba_debug=*The setting persists in localStorage for that browser. Namespaces are listed in
Debug logging.
Record which theme you are looking at before you change anything. Shopify Admin, Online Store, Themes shows which one is
live, and npm run list prints every theme with its ID and role. A bug reproduced on a preview theme and a bug on the
live theme are different incidents.
Use a private browser window. localStorage holds debug settings, popup frequency and cart state, and a normal window
will keep showing you stale behaviour.
Rolling back
For a code problem on the live theme, republish the previous theme in Shopify Admin, under Online Store, Themes. Previous versions stay on the store for exactly this reason. Detail is in Deployment.
For a settings problem, the theme editor has no undo. The previous values are in config/settings_data.json on the
production branch, from the last automated pull. Read the value out of git and re-enter it in the theme editor.
Escalating
| Problem area | Who owns it |
|---|---|
| Appointment availability, reservations | Sesami support |
| Popup creative, email and SMS capture | Klaviyo administrator |
| Booking intent not reaching downstream systems | Zapier Zap owner |
| Discounts and promotions | Discount Ninja support |
| Search and filtering | Boost support |
| Checkout, payments, order data | Shopify support |
A Shopify Admin or app outage is visible on their status pages. Check before spending time in the theme.