Skip to content

Auro Lumen Dev Documentation

Version: 1.6.0 — Development · Published 27 October 2026

This guide documents a development version. The theme is not ready for a production launch. It is not approved, listed or available for purchase on the Shopify Theme Store, and there is no download. Runtime, editor, device, accessibility and performance validation is incomplete.

Complete-release price target: USD 310. This is a future target for a finished release, not a current price: the theme cannot be purchased, and no listing exists.

1. Architectural lighting

Choose a room photograph and meaningful alt text. The entire image retains its natural aspect ratio on small and large screens so marker positions stay attached to the same objects. There is no crop or mobile image substitution. The first template section requests an eager, high-priority image; later positions request lazy loading. Native image/CDN behavior remains unverified.

Set the eyebrow, heading, H1/H2 level, description, caption and object-list heading. Use H1 for the main page heading and H2 for additional room sections. Add up to eight Room object blocks, select a product for each, optionally describe its material or finish, and set horizontal/vertical marker positions from 5% to 95%. Select real products; empty blocks do not produce markers, prices or list rows. Numbering follows configured block order, ignoring empty products.

Each numbered marker links to its matching object-list row. That row links to the selected Shopify product and uses its localized money filter output, including a From prefix for varying prices. Markers do not buy a set, create a bundle or open a quick-buy dialog. The object list works without an image or JavaScript. Avoid overlapping markers; the list is an alternative route for every object. Native currency and editor behavior still need verification.

2. Photometrics & canopy

Available only on product templates. Add the following Dimension metafield definitions to Products and, where sizes differ, Variants in Shopify admin custom data. Use the exact namespace and keys; plain text or number definitions are deliberately ignored.

Namespace/key Type Meaning
auro_lumen.width Dimension External assembled width
auro_lumen.depth Dimension External assembled depth
auro_lumen.height Dimension External assembled height

No definitions or values have been created in a store by this work. Enter verified manufacturer measurements. Never use invented demo dimensions for a real item. Product-level values apply across variants; leave them blank if that is not true. A populated variant value takes precedence for that axis. Missing variant fields inherit the product value. An explicitly populated invalid/unsupported variant field stays unavailable rather than silently inheriting a different size.

Accepted positive source units: millimetres, centimetres, metres, inches, feet and yards (mm, cm, m, in, ft, yd). Liquid normalizes these to centimetres. The browser converts canonical values to inches; repeated toggles do not accumulate rounding error. Display rounds to one decimal place and browser formatting follows the document language. Conversion is presentation only and does not rewrite stored data.

With theme JavaScript absent, centimetres remain visible and unusable unit controls stay hidden. Missing individual dimensions read “Not provided”. If all dimensions are missing/invalid, the storefront section is hidden and the editor receives setup guidance. Heading, introduction and measurement note are editable. Explain packed dimensions and access requirements separately; the section never guarantees a piece fits through a door or in a room.

Dimensions currently resolve during a page render from selected_or_first_available_variant. Version 0.4.0 uses ordinary option-value links that request a new Shopify page, so the product and dimensions are resolved together on each server render. No asynchronous variant controller is used. This relationship is source-tested with selected-variant fixtures; real Shopify option navigation and combined listings still need acceptance. Any future asynchronous variant change must also refresh this section.

3. Evidence and remaining work

Nine new local tests cover typed conversion, overrides, invalid/partial data, empty states, link targets, money formatting, independent controls, locale formatting, reconnection and loading priority. Six actual-source fixtures use mocked Shopify objects and filters. Eighteen responsive observations pass at 320/820/1440px. Theme Check reports no diagnostics on these six files, which does not establish full-theme completeness or native compatibility.

Next: original shell, settings, navigation/section groups and complete required templates; option navigation and product/cart integration; verified manufacturer catalog and detail images; native editor and store QA; commercial name, documentation, support, accessibility and performance acceptance.

Primary implementation references checked 20 October 2026:

4. Shell foundation added in 0.3.0

The independent layout now includes main-content skip navigation, page titles/descriptions/canonical URL, Shopify header content, and separate header/footer section groups. Header settings select a logo and main menu. Native disclosure menus retain three navigation levels without JavaScript. Account links follow the store setting and bag count follows the cart. Footer settings select the information menu and optional note; no developer credit is inserted.

Base colors control paper, ink, accent and dividers. Full color schemes, contrast validation for merchant palettes and font pickers remain pending. Home, page and collection JSON templates exist. The collection uses horizontal object rows with selected product images, individual links and localized money output; filtering/sorting remain pending. Some fixture links intentionally use a generic local page because search, cart and account pages are not implemented by this foundation.

Five additional tests and twelve responsive observations cover the shell. The source now has 19 files. Theme Check reports one unresolved missing product-specific documentation URL error; no URL is invented. Product/cart, remaining required templates, full settings, native acceptance and release metadata are still required. No ZIP/upload has been created for this incomplete project.

5. Product and cart foundation added in 0.4.0

The product template contains Object product followed by Photometrics & canopy. Object product accepts an eyebrow, material note, rich material/care information and rich delivery/access information; connect product metafields where information differs by item. App blocks are allowed in the product section. The current media implementation is a leading variant/product image with a larger-image link; additional images, video, models, zoom controls and pickup are not complete.

Option choices use Shopify option-value IDs, including the linked-product URL when supplied. They request a complete new page rather than enumerating all variants. The selected variant’s native ID, availability and min/increment/max quantity rules determine the product form. Missing combinations, sold-out variants and required plans without allocations cannot submit.

Optional purchase plans retain the one-time choice. Required plans select an available allocation and omit one-time purchase. Each plan displays its own amount, description, per-delivery amount when supplied, amount due now and remaining balance. All plan details remain visible without JavaScript. These are platform-supplied values; the theme does not create subscriptions, finance products or charge schedules. App compatibility, native billing and checkout require verification.

The native cart form contains line quantities, remove links, public line properties, selling-plan names, line and cart discounts, order note, total and update/checkout actions. Private underscore-prefixed properties stay hidden. Empty cart offers a collection link. All local fixture forms are blocked; no purchase or payment has been executed.

Eight new source/data tests pass, with 27 responsive observations across nine states. Source now has 26 files. No package or upload yet. Complete required templates, discovery/filtering, product media, gift cards, pickup, accelerated checkout, font/color-scheme settings, native testing and public documentation before treating this as a complete commercial theme.

6. Discovery added in 0.5.0

Collection and search templates now use native Shopify filter data and sort options. Configure supported filters in Shopify Search & Discovery first; the theme does not create filters. Material/color choices keep visible text alongside visual swatches/images, with unavailable unselected values disabled. Price fields show currency and numeric boundaries. Apply submits selection and sorting together; removal links use Shopify's supplied URLs, and Clear filters preserves sorting and search query/type scope. New search queries keep type scope but start without applied filters.

Results use horizontal object rows. Search also distinguishes journal articles and information pages, with text excerpts. Initial search, no matching results, filtered-empty collection and genuinely empty collection have separate messages. The collection directory lists collections with images or placeholders and optional description excerpts; heading defaults to Rooms and objects.

The native forms work without theme JavaScript by requesting another page. Shopify counts, sorting, filtering and pagination still need native acceptance. Dimensions remain product detail data, not automatically created dimension filters: Shopify's supported metafield filter types must be followed. No unsupported Dimension-type filter is promised.

Eight new regressions and 24 local layout observations pass; source now has 32 files. Remaining content templates, media, full settings and release operations remain incomplete. This guide is not published.

7. Journal and service templates — development 0.6.0

The Journal index uses the selected Shopify blog and paginates twelve articles. Article templates show the merchant's rich content, optional publication date/author and article image. Comments follow the blog's enabled/moderated settings; published comments paginate ten at a time. Moderated submissions receive an awaiting-review message. The theme does not enable comments or change moderation settings.

Assign the page.contact template to a Shopify page for a contact form. Its heading and introductory copy come from the page. The name is optional; email/message are required. Theme code uses Shopify's native contact processing. Delivery, CAPTCHA and actual server errors still need native validation; fixture receipt/error screens are mock states.

The password template uses a separate minimal layout and the native storefront-password form. It never repopulates a credential. The 404 page links to the locale-aware home route. Both are source-tested, not installed. Article structured JSON is escaped to keep script-closing text from breaking out of the data element.

Twelve local fixtures, ten content regressions and 21 responsive observations are recorded. The theme remains incomplete: gift card, full product media, pickup/accelerated checkout, font/color/localization controls and native acceptance remain open.

8. Gift certificate — development 0.7.0

The standalone gift-card template shows issued-card initial value, remaining balance, status, expiry and scheduled date when Shopify supplies them. The code remains manually selectable without JavaScript. Copy reports success or selects the code for manual copying; Print uses a dedicated paper layout. A 160px QR is shown only after Shopify’s QR helper initializes successfully. An Apple Wallet link appears only when Shopify supplies pass_url. Base theme colors apply.

Local fixtures use fictional codes and mocked data. Native issuance, redemption, delivery, QR scanning, Wallet and actual printer output are not verified. This template does not create or issue gift cards. The theme remains incomplete and unavailable for sale.

9. Typography and market selectors — development 0.8.0

Theme settings → Typography provides Body font (Assistant regular by default) and Heading font (Libre Baskerville regular). Shopify font declarations use swap, with available bold/italic body variants. Storefront, password and gift-certificate documents share these settings. Fixtures use system-font mock objects; actual font delivery remains unverified.

The Living footer has Show country selector and Show language selector, both enabled by default. Shopify Markets and published languages determine the choices; the theme does not create currencies, markets or translations. A selector appears only when more than one corresponding choice is available. Country labels include currency code/symbol; language labels use native language names. Customers choose options and press Update preferences, which works without theme JavaScript. Actual market redirects, contextual prices, checkout and translations still require Shopify acceptance. Only an English theme dictionary is bundled at this stage.

Five source tests cover selected values, labels, scoped repeated IDs, singleton/disabled states, escaping and font defaults. Twelve local layouts cover four states at three widths. This remains an incomplete development theme, not a listed product.

10. Pickup and accelerated checkout — development 0.9.0

Object product now has Show local pickup availability and Show accelerated checkout, both enabled by default. Pickup information comes from the selected variant's Shopify store availability. Only locations with pickup enabled appear. The disclosure shows each eligible location's name, formatted address, stock state and, when available, pickup time. An empty response produces no pickup promise. Configure locations, inventory and pickup in Shopify; this theme does not enable them.

Product express checkout uses Shopify's native payment button within the product form. It is absent for nonexistent/sold-out variants or a required purchase plan without a valid allocation. Object cart has its own Show accelerated checkout setting; Shopify determines which wallets are available. The cart hides wallets after quantity or order-note edits until the saved values are restored or Update bag saves them through Shopify. Normal Checkout remains available to submit the native form. Without theme JavaScript, the normal cart checkout remains and wallet buttons stay hidden so unsaved edits cannot be bypassed.

Seven new local regressions and twelve responsive observations cover eligible locations, unavailable stock, missing/disabled data, product plan/variant gating, note/quantity changes, invalid input, reset, page restoration and repeated section lifecycles. All 232 repository tests pass. Fixtures use fictional locations and disabled wallet stand-ins. No actual pickup reservation, payment, wallet, order or Shopify installation has been tested for this theme. Full media and section color schemes are still incomplete. The public documentation URL remains unset, producing the existing Theme Check error.

11. Product media — development 0.10.0

The Object product media index now leads with the selected variant's featured media, then presents the rest of the product media once each. Add media and assign variant images in Shopify Products. The first image loads eagerly; later images are lazy. Media descriptions are used for accessible labels and visible captions, so write useful descriptions rather than filenames.

Image links open the full-size asset without theme JavaScript. Supported browsers enhance ordinary clicks into an enlarged-image dialog; Close image or Escape returns focus to the original image link. Modified clicks preserve normal link navigation. Shopify-hosted videos retain native controls with no autoplay. External videos load after a customer presses Load video; a noscript embed is provided when browser JavaScript is disabled.

3D models retain a preview while interactive controls load on request. A load failure preserves that preview and offers retry. View in your space is left hidden until Shopify's XR library identifies a supported device. These controls need native Shopify and device validation before they can be advertised as supported release features. Starting another media item pauses hosted video/models and removes the previous external iframe; leaving the document or removing a section also releases active media.

The furniture media layout is an editorial image index. Long mobile galleries still need design refinement with realistic detail imagery. Local fixtures deliberately reuse an original room image and mechanical test clip; they are not a finished catalog. External provider playback, real ModelViewerUI, AR, accessibility with assistive technology and native editor lifecycle remain unverified.

Eight source/lifecycle tests and twelve responsive observations supplement previous checks; all 240 repository tests pass. Theme Check reports the existing missing public documentation URI error and one advisory for Shopify's official model-control stylesheet. This source remains incomplete and unpackaged.

12. Section color schemes — development0.11.0

Theme settings > Color schemes contains Chalk, Walnut and Clay starting palettes and a default scheme. Each of the15 sections has its own Color scheme selector. Configure background, text, button and button-label colors, dividers/input borders, measurement-panel background/text and focus outline. Optional background gradients retain solid colors for small surfaces and controls. The dimensions section deliberately uses the measurement-panel pair. Menus, option borders, quantity fields and contact fields inherit section tokens; global password/gift contexts use the default scheme. Existing legacy base values remain fallbacks when no resolved scheme is available.

Preset solid text/button/panel pairs pass calculated4.5:1 contrast; tested focus/border pairs meet3:1. Changing colors or adding gradients requires a fresh contrast check. Nine local responsive observations and a mobile inch-toggle test are source-fixture evidence, not Shopify editor or accessibility certification. Native editor persistence, fonts, app/commerce and device checks remain open.

15. Sharing, social profiles and accounts — 0.14.0

Theme settings → Sharing and browser icon sets a default sharing image and favicon. A page-specific image takes precedence. Product metadata uses Shopify structured data, and canonical titles retain tags and pagination. Gift certificates remain noindex and do not publish social metadata.

Theme settings → Social profiles provides optional Instagram, Facebook, TikTok, YouTube, Pinterest and X URLs. Empty defaults create no social links. Footer → Show social profiles controls the group. All links have visible network names.

When customer accounts are enabled in Shopify, the header uses Shopify’s native Account component. The optional customer-account menu selects its navigation; blank uses the platform default. Sign-in UI and account behavior are controlled by Shopify. Native account acceptance for this furniture theme remains pending.

Editor labels and text defaults now reference the English schema locale. Setting IDs, choice values, ranges and saved configuration contracts are unchanged. This does not add other-language translations.

Validation: 10 new regressions,389 repository tests and9 local responsive observations. These fixtures use an inert account host and do not establish installed Shopify/editor behavior. Missing own public documentation URI still prevents a clean Theme Check and packaging.

16. Newsletter and Follow on Shop — source 0.15.0

Add the Newsletter section to a JSON template in the theme editor. Configure its heading, text and color scheme. The form uses Shopify’s customer/newsletter endpoint; email consent text and an available shop privacy-policy link are shown. Error and success feedback belong to each section. Shopify controls subscriber storage, confirmation and consent settings; test the real flow before launch. No theme JavaScript is needed for submission.

The footer’s Follow on Shop setting is off by default. Enable it to request Shopify’s native branded control; the platform controls eligibility and appearance. The theme does not reproduce or recolor that button. Local fixtures use an inert placeholder and do not verify a real follow.

Native option swatches now display image, color or text while retaining option-value navigation. Collection cards show unit prices when supplied by Shopify, and show an original price only for uniform comparable product prices. Gift-card recipient controls and collection images remain confirmed source gaps; neither this source nor its guide is release-ready.

17. Gift recipients and collection images — 0.16.0

Main product and featured product sections have a Show recipient fields for gift cards setting, enabled by default. It only applies to Shopify gift-card products. The native product form supports recipient email, optional name/message/date and the Shopify send flag. The merchant’s accelerated product checkout is omitted while this feature is enabled because it cannot validate these fields. Existing cart property rendering shows the customer-facing values and hides internal underscore properties.

With JavaScript, enabling the recipient choice makes email required and enables the payload; disabling it omits the details. The date is limited to90days and browser timezone offset is supplied. Form reset, history restoration and editor reconnect are handled. Without theme JavaScript the fields remain visible and Shopify performs final validation using the shop timezone when the browser offset is absent. Actual validation, cart/checkout, gift fulfillment and email receipt must still be tested in Shopify.

Collection sections now have a Show collection image setting. Upload a descriptive image and alternative text to the collection in Shopify. Images use responsive sources and preserve their aspect ratio within a65vh display cap; blank images produce no empty frame. Local fixture imagery is for sizing checks only.

Cart quantity constraints

Quantity updates use the variant minimum, increment and maximum, with a required value. Remove a line using its separate Remove link. Empty and invalid values fail native browser validation. Express buttons remain hidden for invalid or unsaved quantities/notes, including during form reset. Shopify remains responsible for server validation. Native B2B and payment acceptance are still pending.

18. Accessible pricing — source 0.16.4

Product, purchase-plan and catalog prices now include translated nonvisual regular/sale descriptions. Cart amounts distinguish original, discounted and normal line totals; unit-price output includes its purpose. Variable-price cards retain conservative compare-at behavior. These labels do not change prices or discounts. Source and responsive fixture checks do not establish native screen-reader, subscription or release acceptance.

19. Search result totals — source 0.16.5

The result total and list are evaluated inside the same Shopify pagination scope. This follows a native count discrepancy reproduced in Steepfolio. The initial search view remains outside the result scope. Counts, sorting and indexing remain Shopify-owned. Existing local search regressions pass; this study still needs its own native installation and search acceptance.

20. Per-item cart amounts — 0.16.6

Cart records show the price for one item separately from the line total for its quantity. Shopify supplies both amounts; rounding and plan adjustments are preserved. A higher original item price is crossed out beside the discounted amount, including a zero final price. Unit measurements and discount allocations remain separate. This source behavior has local coverage; native installation and complete checkout acceptance are still pending.

21. Room editor targets and heading hierarchy — 0.16.7

Each unassigned room-object block has its own numbered setup prompt in the editor, carrying Shopify's block attributes. Choose a product in that block; empty product slots stay absent from shopper output and do not create markers or disrupt the numbering of linked objects. Reordering assigned objects keeps their marker links aligned with the current list.

A page-level room heading uses H1, its object-group heading H2 and object titles H3. When the room is a supporting H2 section, these become H2/H3/H4. Both modes share their existing visual styles. Local rendered-source tests and responsive fixtures verify the markup; native editor selection, physical devices and assistive-technology acceptance remain pending.

Shopify describes the block attributes and editor visibility contract in its section and block integration guidance, checked22October2026. These source fixes do not establish full Theme Store compliance.

Newsletter keyboard focus — 0.16.8

The newsletter email field and Subscribe button now use the section contrast token for their outside keyboard-focus ring. Previously the button inherited its light label color, producing a ring identical to the surrounding paper in every supplied palette. Keep the existing four-pixel offset. The supplied solid schemes pass local computed-color checks at 320, 390 and 1440 pixels; custom schemes, gradients, forced colors, screen readers and native editor/device testing still need validation. No newsletter submission was made during this review. See the source-specific observations in docs/evidence/portfolio-focus-after-20261023.json.

Room markers over photography — 1.5.0

Focused room markers now place a solid paper-colored halo behind the outline so the ring is distinguishable from merchant photography. The outline uses the existing palette focus token; the target remains44pixels. Native fragment navigation into the object list and the measurement radio controls are preserved. Local keyboard checks cover supplied palettes, long labels and no-script output. Custom colors, native editor/device and full accessibility acceptance remain separate. Evidence: docs/evidence/niche-keyboard-release-20261023.json.