Changelog

This changelog tracks the Arcanum-hosted documentation set and its coupling to the Liquid theme. Theme behavior changes still ship via Shopify theme versions; cross-check shopify/themes/studio-arcana/README.md for manual smoke gates.

1.8.10 — Placeholder merchant guides completed

• Filled EN/ES merchant docs for Theme settings (overview, brand, motion, SEO, shape, age), app block surfaces, Ritual Builder setup, email/forms, typography, color schemes, icons/badges, page transitions, spacing density, and advanced CSS/customizations.
• Converted Ritual Builder and App block surfaces articles to structured `blocks` (same renderer as other guides).
• Cleared PLACEHOLDER_ARTICLE_KEYS — launch-critical setup guides are no longer stubs. Docs: https://www.arcanumhollow.com/en/shops/docs/studio-arcana

Product, booking, and retail guides

• Product pages guide (EN/ES): service Book-first buy box, retail action guards, gallery status, sticky stacking, and search structured data.
• Set up booking links (EN/ES): service PDP app mount, fallback URL, consultation labeling, and external scheduler hints.
• Retail conversion (EN/ES): retail PDP checklist, aftercare pairings, sticky Add to cart vs cart drawer, and notify form scope.

Afternoon launch — priorities, statuses, and honest auto-detect

• Theme Editor Afternoon launch shows Next up (about three actions) plus View full checklist.
• Statuses: Required, Recommended, Complete, Manual verification — written as text; incomplete rows explain what is missing, why it matters, and where to fix it.
• Booking auto-complete needs a booking base URL or a page with handle booking — provider default alone is not enough.
• Full launch checklist guide (EN/ES) updated for the new panel behavior.

1.8.9 — Theme editor setting order

• Section and block settings now follow a consistent order: Content → Data source → Actions and links → Layout → Media → Colors → Spacing → Advanced behavior.
• Larger sections show group headings for those buckets; small sections may skip headings to keep the panel short.
• Saved values are unchanged — setting IDs and defaults were preserved. See Theme settings overview for merchant guidance.

1.8.8 — Per-service before/after on service templates

• Before/after gallery: Content source Theme Editor blocks (homepage) or Current product (`custom.transformations` → `studio_transformation` metaobjects) so each service has its own results.
• Empty product transformations hide the section on the storefront; theme editor shows a setup hint.
• product.service defaults to Current product. After a code-only theme push, set Content source once in the editor if the remote template still uses blocks.

1.8.7 — Studio locations media, packages cards, spacing tokens

• Studio locations: Media type Map or Image, Media position Left or Right; optional studio_location Image file field (key image) documented for Admin Custom data.
• Packages & memberships: product featured image, shared card presentation (style, hover, tilt, shadow), CTAs use section color scheme primary/contrast.
• Shared typography gaps: --sa-eyebrow-heading-gap, --sa-heading-desc-gap, --sa-title-desc-gap plus .sa-section-intro / .sa-title-desc utilities.

1.8.6 — Storefront performance (feature-safe)

• Idle-deferred decorative motion and engagement work (portfolio, lookbook, marquees, quiz chrome, magnetic CTAs, card tilt) so first interaction stays responsive without removing features.
• Script loading: product JS no longer loads on generic pages (wishlist/compare still load); engagement also loads on blog, article, and search so header predictive search binds.
• Media: mid-page Image banners lazy-load; before/after priority images only when the section is first in the template.
• Compare UI skips hydrate work when no compare markers are on the page; recently viewed initializes on idle.

1.8.5 — Journal schemes, image styling, and modal polish

• Main blog, Main article, and Featured blog: section color schemes paint card surfaces, borders, muted text, and accents; section dividers available.
• Images and cards: gallery mask, hairline, image ratio, crop position, card tilt, and standard vs editorial offset via sa-article-card.
• Article hero uses the same mask / ratio / position settings as related cards.
• Quick view: closes after a successful add to cart, traps focus and restores it to the opener, and eases open/close with a fade plus gentle height change when content loads.
• Size chart, image zoom, and portfolio lightbox use the same focus-trap and restore pattern; dialogs respect reduced motion and Animations off.
• Theme editor: Theme settings sidebar reordered (design groups before ops); Galleries and section dividers moved out of Motion; Header, Announcement bar, and Main product setting groups reordered for clearer rails.

1.8.4 — Modal overlay scrim

• Theme settings → Colors: Scrim color and Scrim blur for drawers, dialogs, and popups.
• Shared CSS tokens (--sa-modal-scrim-color, --sa-modal-scrim-blur) drive cart, header drawer, quick view, size chart, galleries, newsletter, age gate, filters, and predictive search.

1.8.3 — First-class journal / blog

• Main blog index: featured post, tag filters, paginated article cards.
• Main article: date, author, tags, share, reading progress, related posts.
• Featured blog homepage section (Studio journal) with empty-state guidance.
• Seed posts tagged aftercare / first-visit / policies / featured across verticals.

1.8.2 — Header utilities, promo depth, and launch evidence

• Header: place search, account, cart, and other utilities in a slim row above the primary header, with separate order and alignment.
• Book button placement: with utilities, at the end of the primary menu (button style), or both.
• Promo tiles section: campaign merchandising grid with badges, CTAs, and optional schedule windows (discounts stay in Shopify Admin).
• Product card badges: Sale, sold out, New (badge:new / new), custom.product_badge or badge:… tags; optional custom.card_label eyebrow override.
• Expanded tests for collection AJAX filters/sort, mega menu, lookbook, cart AJAX, booking dual-path, Beauty preset acceptance, and metaobject empty states.
• CI staging-secret mode for Playwright, visual, and Lighthouse release evidence (PR stays soft without secrets).
• Docs: competitive-gap evidence matrix, retail conversion + search/discovery guides, marketplace honest-parity notes.

1.8.1 — Metaobject Social links

• Social links: source modes Merge / Metaobject / Manual; auto-match Studio specialist (profile_page) or Studio location (location_page), plus optional location picker; manual blocks override the same network.
• studio_specialist and studio_location metaobjects gain optional social URL fields and location_page; seed samples and definition sync updated.
• Specialist-profile and studio-locations templates include Social links (merge) by default.

1.8.0 — Merchant excellence release

• Buy box setup notices for service products, missing booking URLs, and unavailable payment icons in the theme editor.
• Booking setup fallback section on /pages/booking with step-by-step merchant guidance.
• Trust badges section for licensing, sterilization, and policy proof blocks.
• Cart recovery CTAs: browse services, book consultation, and shop aftercare from empty cart states.
• Launch checklist auto-detects payment providers and type:service products.
• Service cards show duration from metaobject or product metafields; metaobject lists show empty-state guidance.
• New analytics event: studio-arcana:booking:click.
• Performance transfer budgets enforced in theme preflight; Playwright matrix expanded to Chromium, mobile, WebKit, and Firefox.
• Reserve Theme Bridge: Booking provider setting (Hollow Reserve recommended, External fallback), dual-path Book CTAs, hollow-reserve:open handoff, aftercare refresh on hollow-reserve:booked.
• Card style Full image background: photo fills the card with overlay copy (overlay opacity, light/dark text on media, banner height) on service, specialist, product, ritual, aftercare, and before/after cards — same idea as Image banner, sized for grids.
• Hero service with image/video: Color scheme still drives copy, buttons, and overlay tint (Text on media default is Color scheme; Light/Dark remain contrast overrides).
• Image banner (section + column block): Color scheme drives copy, buttons, and overlay tint; buttons use Theme settings → Button radius.
• Quick view: fixed stuck loading state caused by split theme bundles missing shared product section URL helpers.
• Buy it now / accelerated checkout: wallet buttons use Theme settings button radius; unbranded Buy it now uses section color-scheme primary tokens.
• THEME_VERSION aligned to 1.8.0 for Theme Store RC documentation on https://www.arcanumhollow.com.
• Lookbook: up to four shop-the-look hotspots per look with independent X/Y, discovery filters/load-more, and distinct gallery media masks.
• Portfolio gallery: progressive load (show all, load more, or on scroll) with lightbox limited to currently revealed photos.
• Studio locations: shared location cards, specialist chips, tabs/cards layout, directions, open-now, deep links, and per-location LocalBusiness JSON-LD.
• Column splitter: nest Column theme blocks (optional per-column headings) with Image banner, FAQ, and Studio locations children for side-by-side layouts.
• Booking setup fallback: button label no longer pipes merchant text through | t (fixes Translation missing for Open booking); blank label uses booking_setup.cta.
• Local trust certification badges: image position top, left, or bottom relative to the caption.
• Collapsible row (product buy box): Border none, bottom only, or full outline, plus optional corner radius.
• Social links section: placeable profile icons (Instagram, TikTok, and more) on any template or header/footer/aside group.
• Empty cart: featured layout with bag/spark/custom illustration, shared heading/message/subtext, and recovery CTAs under Theme settings → Cart.
• Reliability pass: section Continue URL precedence, locale-aware drawer checkout, booking fallback MutationObserver, mobile parent menu links, collection filter focus trap, lazy LQIP placeholders, heading font preload off by default, deferred model-viewer, and stronger Lighthouse/performance budgets.
• Size chart (retail): built-in sample chart content on the block (edit in place); optional page / custom.size_chart override; dialog heading, intro, measure image; polished table styles; hidden on service PDPs.

1.7.0 — Marketplace-ready documentation release

• Expanded Full launch checklist covering store/account, brand, navigation, catalog, services/specialists/locations, booking, homepage journey, cart/retail, SEO/privacy, accessibility/performance, analytics, and publish/handoff.
• New merchant guides: Locations, Search and discovery, Retail conversion, Retention and accounts, Privacy and consent — plus a deeper Performance guide.
• Theme capabilities: optional product compare (/pages/compare), availability notify on sold-out variants, rebook prompt section, Conversion Starter homepage presets per vertical, specialty filters on Specialist team, and coordinated kit add-all for ritual bundles.
• Overview, Booking links, Revenue setup, Accessibility, and Troubleshooting updated for marketplace-ready capabilities and upcoming Conversion Starter / Full Editorial presets.
• THEME_VERSION bumped to 1.7.0 to mark this documentation and readiness narrative on https://www.arcanumhollow.com.

1.6.1 — FAQ caret and background

• FAQ and policies: **Caret position** (left or right edge of each question).
• FAQ and policies: **Question background** — surface color or transparent (border only).

1.6.0 — Service product page differentiators

• Service chips (duration, healing days, consultation), session timeline, artist card, contraindications, deposit note, and consent gate (tag **requires_consent**).
• Sticky buy bar modes: Auto, Buy, Book, or Dual.
• Location note block; **product.service** template includes optional before/after gallery.

1.5.0 — Product page layout and buy-box blocks

• Desktop media | buy-box grid with media position, size, and gallery layouts (carousel, stacked, thumbs, collage).
• Hide other variants’ media; size chart dialog; collapsible rows; icon with text; payment icons on buy buttons.
• Inventory urgency modes; trust strip; availability note; related products section; templates **product.service**, **product.retail**, **product.gift**.
• New merchant guide: Product pages.

1.4.9 — Cart drawer quantity UX

• Cart drawer: quantity changes no longer flash the full skeleton — soft busy state keeps the panel visible.
• After a quantity update, scroll position and focus on that line’s quantity field are restored.
• The per-line **Update** button is hidden when JavaScript is active (quantity already saves automatically; Remove stays). The button remains for shoppers without JavaScript.

1.4.8 — Cart drawer theme styling

• Cart drawer: fixed broken line-item CSS from the Theme settings → Cart move.
• Drawer continue CTA, inputs, and upsell panels now use theme radius, card surface, and primary button tokens so the slide-out matches the rest of Studio Arcana.

1.4.7 — FAQ content alignment

• FAQ and policies: **Content alignment** (left, center, or right) for the heading and answers in one shared column.
• Title and accordion list stay the same width so center and right alignment line up correctly.

1.4.6 — Theme settings Cart

• Theme settings → Cart: cart type (Drawer / Page), open drawer after add, vendor, accelerated checkout, shared goal bar, discount, notes, empty-cart CTA.
• Merchant toggles for service aftercare, book-treatment, and retail recommendation upsells on drawer and /cart.
• Cart drawer and Main cart sections keep titles and empty messages only; shared chrome reads theme settings.

1.4.5 — Service card icons and text alignment

• Service menu: each Service card can show a preset or custom icon.
• Section settings: **Icon position** (top or left of copy) and **Card text alignment** (left or center).

1.4.4 — Card shadow at rest

• Theme settings → Shape and spacing: **Card shadow at rest** — Off (flat), Subtle, Soft, or Same as theme character.
• Turns off the default (non-hover) card drop shadow. Linked-card hover lift is unchanged.

1.4.3 — Short description color in color schemes

• Theme settings → Color schemes: **Short descriptions** is a second text color for card copy (service, team, aftercare, ritual).
• Titles still use **Text**. Existing stores keep the softer mix of Text until you pick a color.

1.4.2 — Secondary menu above the primary header

• Header: Secondary menu placement includes **Above the primary header** (and drawer + above). Alignment is left, center, or right.
• Above-primary alignment: left, center, or right.
• Header navigation guide updated (en + es). THEME_VERSION bumped to 1.4.2.

1.4.1 — Section padding sizes in Theme settings

• Theme settings → Shape and spacing: Extra small / Small / Medium / Large / Extra large pixel sizes for section padding.
• Per-section Padding top/bottom can pick Extra small; sizes scale with Section spacing density and Theme character.
• Merchant guides: Shape and spacing + spacing density reference updated (en + es).

1.4.0 — Standout epic: modular PDP, Markets, merchandising, locales

• Modular product buy-box blocks (price, payment terms, vendor/SKU/inventory, gift card recipient, pickup, share, dynamic checkout).
• Markets localization form in header/footer; gift-card promo page; cart AJAX parity and selling-plan drawer lines.
• Merchandising sections: featured product, collection list, image banner; lookbook hotspots; micro-interactions setting.
• Service moat: studio locations, packages/memberships, account preferred specialist + reorder aftercare, quiz product shelf fix, location-aware booking URLs.
• Locales fr/de/pt-BR (+ schema); RTL dir on html; Spanish guide parity updates.
• THEME_VERSION bumped to 1.4.0.

1.3.0 — Delivery polish: speed, revenue loop, Theme Store completeness

• Storefront loads minified JS bundles; lean Motion defaults (subtle intensity, magnetic/Lenis/page transitions off).
• Cart aftercare upsells show Top pick + Also consider; quiz results can link to specialist profile pages.
• Launch checklist adds first booking and first aftercare sale sign-off steps.
• Vertical service-detail templates for hair, spa, and tattoo intake/policy defaults.
• Classic customer account templates, list-collections, Spanish Theme Editor schema (es.schema.json).
• Merchant guides rewritten as simple required → optional → how to check steps (en + es).
• THEME_VERSION bumped to 1.3.0.

Announcement bar — scheduling (merchant docs)

• Announcement Bar section page now documents Message block scheduling (date window, weekdays, shop timezone, caching).
• Section deep pages support optional scheduling_title, scheduling_lead, and scheduling_bullets in theme-docs JSON.

1.2.0 — Header navigation upgrade

• Header utility display modes (text, icons, icons with labels) with separate mobile defaults.
• Shopify account component (shopify-account) for new customer accounts; customer account menu setting.
• Search styles: icon modal, inline desktop bar, or drawer-only; drawer search row.
• Desktop layout options including logo center inline; optional separate mobile menu.
• Phone link, secondary utility menu, mobile header utility placement, and utility order.
• New guide: Header navigation (en + es). THEME_VERSION bumped to 1.2.0.

1.1.0 — Launch checklist, retail parity, revenue guides

• Theme settings Launch checklist panel with editor preview overlay (sa-launch-checklist.liquid).
• Quick view parity: media gallery, selling plans, and complementary products.
• Header wishlist icon with localStorage count badge; quiz result product recommendations.
• New guides: Launch checklist and Revenue setup (en + es).
• THEME_VERSION bumped to 1.1.0; D2 smoke rows for quick view, wishlist, and launch checklist.

1.0.0 — First-class docs IA

• Introduced category-led navigation (install, guides, settings, sections, reference, advanced, videos, updates, feedback).
• Added per-section documentation pages backed by generated section-schemas.json.
• Added structured JSON blocks (figures, Looms, settings tables) and DocVersionBadge tied to THEME_VERSION.
• Split theme settings into area-specific guides and added templates & URL map for developers.
• Added i18n parity checker (pnpm check:theme-docs) and bootstrap helper for new articles.