Theme Documentation · Shopify OS 2.0
AuraBeauty
Luxury Theme
A fully customisable, editorial-grade Shopify 2.0 theme built for luxury beauty brands. Every section is designed to communicate refinement, trust, and the transformative power of a skincare ritual.
Changelog
What's New in v2.1.0
Version 2.1.0 expands the Theme Settings panel significantly and adds several improvements across sections and templates.
Choose from 25 heading fonts and 25 body fonts, all served via Google Fonts. Fine-tune 6 font sizes (hero headline, section title, sub-heading, large heading, body, small, label) with pixel-level range sliders directly in Theme Settings.
Theme Settings → TypographyThe Colors panel now exposes 11 individually customisable variables — split into Backgrounds, Text Colors, and Accent Colors — including the previously hard-coded ivory, sand, taupe, gold-light, and body text colors.
Theme Settings → ColorsNew dedicated panel for primary and ghost button colors — background, text, hover state — without needing to edit CSS.
Theme Settings → Buttons & LinksNew panel with global toggles: enable/disable scroll animations, show/hide breadcrumbs, switch cart between drawer and full-page mode, and inject custom CSS without editing files.
Theme Settings → AdvancedThe Featured Spotlight section now supports up to 4 Ingredient Callout blocks — floating labels pinned to any position on the product image using X/Y percentage coordinates.
sections/featured-spotlight.liquidFooter now offers 5 layouts (up from 4): Brand + columns, Centered minimal, Newsletter focused, Mega editorial, and a new Compact bar layout.
sections/footer.liquidShips with 5 additional named product templates pre-configured for specific products: face-wash, herbal-face-wash, herbal-hair-mask, herbal-hair-shampoo, and herbal-ubtan-face-mask.
templates/product.*.jsonTikTok URL added to the Social Media settings group, joining Instagram, Pinterest, YouTube, and LinkedIn.
Theme Settings → Social MediaArchitecture
File Structure
The theme follows the standard Shopify theme directory layout. All custom CSS and JavaScript lives in two dedicated asset files — lumiere.css and lumiere.js — keeping the codebase clean and maintainable.
Getting Started
Installation Guide
AuraBeauty-Theme.zip file and click Upload.main-menu. The header and mobile nav both read from this list automatically.assets/ and are displayed as placeholders in every section. You can leave them temporarily while you set up your store — they are only replaced when you upload your own images in the Theme Editor.
Design System
Color Palette
The theme uses a warm, luxury beauty palette defined as CSS custom properties in lumiere.css. In v2.1.0 all 11 core palette colors are customisable via Theme Settings — including the previously hard-coded tonal scale.
Backgrounds
Text Colors
Accent Colors
Design System
Typography
25 heading fonts available in Theme Settings. Weights used: 300, 400, 500 (regular + italic)
25 body fonts available in Theme Settings. Weights: 200, 300, 400, 500.
Design System
Icon Library
Icons are rendered via snippets/icon.liquid as inline SVG. Each icon is a custom path (no external library) and inherits currentColor.
{%- render 'icon', name: 'leaf', size: 24 -%}
{%- render 'icon', name: 'sparkle', size: 20 -%}
{%- render 'icon', name: 'check', size: 16 -%}
| Icon Name | Use Case | Category |
|---|---|---|
| leaf | Clean / natural ingredients | Brand |
| flower | Botanical / floral | Brand |
| droplet | Hydration / serum | Brand |
| sparkle | Glow / luxury highlight | Brand |
| sun | SPF / morning routine | Brand |
| moon | Night routine | Brand |
| flask | Clinically tested / lab | Brand |
| lab | Science / formula | Brand |
| globe | Sustainability / global | Brand |
| recycle | Recyclable packaging | Brand |
| cruelty-free | Cruelty-free certification | Brand |
| shield | Protection / guarantee | Trust |
| heart | Wishlist / favourites | UI |
| star | Rating / awards | UI |
| award | Accolades | UI |
| check | Comparison ✓ / verified | UI |
| close | Modal / drawer close | UI |
| arrow-right | CTA arrows / navigation | UI |
| clock | Time-sensitive / ritual timing | UI |
| bottle | Product / packaging | Product |
| feather | Lightweight / gentle | Brand |
| gift | Gifting / rewards | Commerce |
| shipping | Delivery / fulfillment | Commerce |
| Newsletter / contact | Commerce | |
| Social links | Social | |
| Social links | Social | |
| youtube | Social links | Social |
| Social links | Social | |
| Social links | Social | |
| tiktok | Social links | Social |
| x-twitter | Social links | Social |
sparkle path as default. To add new icons, append a when 'your-icon-name' case to snippets/icon.liquid.
Theme Settings
Global Settings
Found in Theme Editor → Theme Settings. These settings apply site-wide and are accessible in Liquid via settings.*.
Branding
| Setting | ID | Type | Description |
|---|---|---|---|
| Logo image | logo | image_picker | Site-wide logo used in header and footer. Leave empty to use shop name as text. |
| Logo width | logo_width | range | 60–300 px, default 140 px |
| Favicon | favicon | image_picker | Browser tab icon. Recommended: 32×32 or 64×64 px. |
Colors
| Group | Setting | ID | Default |
|---|---|---|---|
| Backgrounds | Page background | color_cream | #FAF7F2 |
| Backgrounds | Section background | color_ivory | #F3EDE3 |
| Backgrounds | Border & divider | color_sand | #E8DFCF |
| Text Colors | Primary text & buttons | color_dark | #1C1410 |
| Text Colors | Body text | color_text | #2E2219 |
| Text Colors | Secondary / muted text | color_muted | #8A7560 |
| Accent Colors | Primary accent (Bronze) | color_bronze | #A07850 |
| Accent Colors | Gold | color_gold | #C9A84C |
| Accent Colors | Taupe | color_taupe | #C4A882 |
| Accent Colors | Gold light | color_gold_light | #E8D5A3 |
Social Media
| Platform | ID |
|---|---|
social_instagram_link | |
social_pinterest_link | |
| YouTube | social_youtube_link |
social_linkedin_link | |
| TikTok New | social_tiktok_link |
Theme Settings
Typography Settings New in 2.1.0
Found in Theme Editor → Theme Settings → Typography. Provides full control over typeface selection and font sizing without touching any files.
Heading Font
| Setting | ID | Range / Options | Default |
|---|---|---|---|
| Heading typeface | font_heading_family | 25 Google Fonts options | Cormorant Garamond |
| Hero headline size | fs_hero | 48–120 px, step 2 | 76 px |
| Section title size | fs_3xl | 36–80 px, step 2 | 52 px |
| Sub-section heading size | fs_2xl | 24–64 px, step 2 | 42 px |
| Large heading / logo text size | fs_xl | 18–48 px, step 1 | 28 px |
Body Font
| Setting | ID | Range / Options | Default |
|---|---|---|---|
| Body typeface | font_body_family | 25 Google Fonts options | Jost |
| Body text size | fs_base | 12–20 px, step 1 | 14 px |
| Large body text size | fs_lg | 15–26 px, step 1 | 20 px |
| Small text size | fs_sm | 10–16 px, step 1 | 12 px |
| Label / tag text size | fs_xs | 8–14 px, step 1 | 10 px |
Theme Settings
Buttons & Links New in 2.1.0
Found in Theme Editor → Theme Settings → Buttons & Links. Controls button colors globally without CSS edits.
| Button | Setting | ID | Default |
|---|---|---|---|
| Primary | Background | btn_primary_bg | #1C1410 |
| Primary | Text color | btn_primary_text | #FAF7F2 |
| Primary | Hover background | btn_primary_hover | #A07850 |
| Ghost | Text & border color | btn_ghost_text | #1C1410 |
| Ghost | Hover color | btn_ghost_hover | #A07850 |
Theme Settings & Sections
Header Section
The header is grouped via sections/header-group.json. It supports 5 distinct layout presets, sticky behaviour with a frosted-glass backdrop, and an optional CTA button alongside the cart / account icons.
main-menu. Create or edit this list under Online Store → Navigation.
Theme Settings → Header
| Setting | ID | Default |
|---|---|---|
| Header background | header_bg | #FAF7F2 |
| Nav link color | header_text | #2E2219 |
| Header bottom border | header_border | #E8DFCF |
| Header layout | header_layout | logo-left |
Section Settings (sections/header.liquid)
| Setting | ID | Default | Notes |
|---|---|---|---|
| Layout style | layout_style | classic | 5 options: classic · logo-left · logo-left-compact · centered-stacked · bold-cta |
| Header logo | logo | — | Overrides the global logo for the header only |
| Logo width (desktop) | logo_width | 150 px | Range: 60–320 px |
| Logo width (mobile) | logo_width_mobile | 110 px | Range: 50–220 px |
| Sticky header | sticky | true | Fixes header to top on scroll |
| Frosted glass | enable_blur | true | Backdrop blur on scroll |
| Show bottom border | show_border | true | Decorative 1 px bottom border |
| Show account icon | show_account | true | — |
| Show search icon | show_search | true | Links to the native Shopify search page |
| Show cart icon | show_cart | true | Opens the AJAX cart drawer |
| Show CTA button | show_cta | false | Optional "Shop Now" style button in the nav |
| CTA text | cta_text | Shop Now | — |
| CTA link | cta_url | — | Destination URL for the CTA |
Theme Settings
Advanced Settings New in 2.1.0
Found in Theme Editor → Theme Settings → Advanced. Global switches and a custom CSS field.
| Setting | ID | Default | Notes |
|---|---|---|---|
| Enable scroll animations | enable_animations | true | Disabling removes all IntersectionObserver-driven entrance effects |
| Show breadcrumbs | show_breadcrumbs | true | Global toggle for the breadcrumb on product and collection pages |
| Cart style | cart_type | drawer | drawer = slide-out AJAX panel · page = full cart page at /cart |
| Custom CSS | custom_css | — | Injected in a <style> tag in the <head> — no file editing required |
Homepage Sections
Hero Banner
Full-screen editorial hero with a background image, centred copy, a floating product frame (right column), a stat strip at the bottom, and a scroll-indicator line. Supports animated entrance via .animate-up and .animate-fade.
Blocks: Add up to 4 Stat blocks (number + label). These appear in the bottom stat strip. Default values: 12k+ Happy Devotees · 4.9 Average Rating · 98% Would Recommend · 18 Months of R&D.
Sections
Announcement Bar
A single-line banner at the very top of the page for promotions, shipping thresholds, or new launches. Grouped inside header-group.json so it scrolls away with the header.
announcement_bg (default #1C1410) and announcement_text (default #E8D5A3).Sections
Marquee Bar
An infinite-scrolling ticker strip, typically placed just below the hero. Items are separated by the · character in a single text field.
· — default "Clean Beauty · Cruelty Free · Vegan Formulas · Dermatologist Tested · Sustainable Packaging · Rare Botanicals · Gold-Infused · Paraben Free"Sections
Icon Strip
A horizontal row of icon + heading + text pairs, typically used just below the hero or marquee bar to communicate USPs. Each block selects an icon from the library and provides a short heading and optional body text. Supports dark mode and a configurable column count.
Blocks: Each item block has icon (from icon library), heading, and text. Default items: Clean Beauty · Cruelty-Free · Sustainable · Clinically Proven.
Sections
Collection Tiles
A grid of editorial category tiles, each linking to a collection. Each tile has an optional overlay icon, a product count badge, a title, subtitle, and a CTA arrow link. Supports dark mode.
Tile blocks: Each tile has: image, overlay icon, count badge, title, subtitle, CTA label, and link URL.
Sections
Featured Spotlight
A large-format editorial split section — product image on one side, full copy on the other — used to spotlight a hero product or new launch. Supports image position toggle (left/right), optional bullet benefit points, and a price + rating display. Supports dark mode.
|title, text, pos_x (horizontal %, default 78), pos_y (vertical %, default 20).
Sections
Ingredient Spotlight
A tab-driven ingredient showcase. Each ingredient block has an image, origin label, headline, body text, a list of key benefits, and a "used in" product link. Ideal for Bakuchiol, 24K Gold, or Hyaluronic Acid storytelling. Supports dark mode. Tab navigation is handled by inline JavaScript within the section.
Sections
Brand Promise
A two-column brand values section. Headline + body text on the left, a vertical list of value pillars (icon + title + text) on the right. An optional stat strip below shows key metrics. Defaults to dark background.
Blocks: Value Pillar (limit 4) — icon, title, text. Stat (limit 4) — number, label. Default pillars: Clean Formulas · Cruelty-Free · Refill & Recycle · Clinically Proven.
Sections
Image with Text
A versatile 50/50 split section with an image on one side and editorial copy (eyebrow tag, heading, body text, CTA button) on the other. Image position (left or right) is configurable via image_right. Optional background color picker.
Sections
Ritual / Story
A split-layout section combining a numbered step-by-step ritual guide (left) with a staggered grid of value cards (right). Steps are auto-numbered 01, 02, 03…. Value cards display with a gold dot, title, and description.
Blocks: Step (title + description) and Value Card (title + description). First two value cards go in column 1; subsequent cards go in the staggered column 2.
Sections
How It Works
An educational section explaining the product mechanism or brand process. Supports two layout variants: cards (icon cards in a row) and timeline (vertical step list). Optionally includes a full-width image above or below the steps.
Blocks: Add step/card blocks with icon (from icon library), title, and description text.
Sections
Before / After
A drag-to-compare slider component. Each block pairs a before and after image with a draggable handle. Supports mouse, touch, and keyboard (arrow keys). Fully accessible with ARIA role="slider" and aria-valuenow. Supports dark mode and an optional CTA button below.
overflow: hidden as the handle moves.Sections
Testimonials
A grid of review cards with star ratings (via snippets/stars.liquid), quotes, customer name, title/location, and a "Verified Purchase" badge. A summary stat strip below shows aggregate review metrics.
Blocks: Testimonial (quote, name, role, rating 1–5) and Summary Stat (number + label). Default stats: 4.9 Average Rating · 2,184 Verified Reviews · 98% Would Recommend · 50k+ Bottles Sold.
Sections
UGC / Instagram Feed
A community photo grid (3–5 configurable columns) simulating an Instagram feed. Each post has an image, caption, username, like count, a video badge, and an optional product tag link that appears on hover as an overlay CTA.
Sections
Lookbook Gallery
An editorial masonry-style image gallery with optional captions. Suitable for beauty look photography, campaign imagery, or editorial lifestyle shoots. Each image block accepts an image and optional caption text.
Sections
Shoppable Hotspots
A lifestyle or flat-lay image with interactive product pins. Click a pin to open a popover product card showing category, name, price, and an "Add to Bag" CTA. Pin positions are set as percentage X/Y coordinates. Closing behavior is fully handled — clicking outside or opening another pin closes the active one.
Sections
Bundle Builder
An interactive step-by-step bundle builder. Customers progress through numbered steps and select products via checkboxes. A sticky summary sidebar shows selected products, calculates the bundle total, and shows savings based on a configurable discount percentage.
₹ as the default currency symbol in its JavaScript total display. To change, edit the var currency = '₹' line inside bundle-builder.liquid.Sections
Product Finder Quiz
A multi-step skin quiz with a progress bar and animated question transitions. After the final question, a product match card is displayed with an optional product image, name, description, and CTA link. Includes a "Retake Quiz" restart button. Defaults to dark background.
Question blocks: Each block has a question and up to 4 answer options. The section settings define the result card (shared across all answers). For personalised results per answer path, this section can be extended with a JavaScript answer-tracking map.
Sections
Comparison Table
A feature-by-feature comparison table for up to 4 products. Columns display image, name, price, and a CTA button, with an optional "Best Seller" highlight badge. Feature rows use smart rendering: yes / ✓ show a check icon; no / ✗ / empty show a dash; any other text renders as-is.
Blocks: Product Column and Feature Row. Feature rows have a label and values val_1–val_4 corresponding to each product column.
Sections
Journal Preview
A blog/editorial preview grid. Each article block has a featured image, category tag, title, excerpt, date, and read-more link. Includes optional section-level "View All" CTA. Supports dark mode.
Default articles feature content about herbal layering, REETHA for hair, and overnight skin renewal.
Sections
Promo Boxes
Up to 3 large image-overlay promo boxes side by side. Each box has a background image, overlay gradient, eyebrow tag, title, and a CTA button. The grid adapts to 1, 2, or 3 columns based on the number of blocks added.
Sections
Press Logos
"As Seen In" logo row. Each logo block can use an uploaded image or fall back to displaying the publication name as text. Each logo is optionally linkable. Background color is customisable via a color picker.
Default publications: Vogue · Elle · Harper's Bazaar · Allure · Marie Claire.
Sections
Newsletter
A centered email signup section with a decorative icon, heading, benefit perk chips, email input, and a submit button. Uses the native Shopify customer form — no third-party app needed. Displays a success message upon submission.
Perk blocks: Add perk blocks — each with a short label. Default perks: 10% Off First Order · Early Access · Expert Skincare Tips.
newsletter in your Shopify Customers list for easy segmentation.Sections
Video Section
Embeds a YouTube or Vimeo video in a responsive 16:9 iframe. Paste the full video URL — the section automatically extracts the video ID for both platforms. Autoplay (muted) can be toggled. Optional eyebrow tag and heading above the video.
Sections
Countdown Banner
A full-width urgency banner with a live countdown timer (hours, minutes, seconds). Configure the target date via a date field, plus optional promotional message, tag, subtext, and CTA button. Supports dark mode.
Sections
FAQ Accordion
An accessible accordion FAQ using the native HTML <details> element for no-JS accessibility with enhanced styling. Each block provides a question and rich-text answer.
Sections
Custom HTML
A free-form HTML block for embedding third-party widgets, trust badge scripts, custom banners, or any markup not covered by existing sections. Content is rendered with {{ section.settings.custom_html }}.
Templates
Template Files
The theme ships with templates for all core Shopify pages plus 5 named product templates pre-configured for specific SKUs. JSON templates allow OS 2.0 drag-and-drop customisation; Liquid templates contain bespoke page layouts.
herbal-face-wash).
Templates
Product Page Section
The full product page section with a media gallery (thumbnails + main image), breadcrumb, star rating (via product metafields), variant selector, quantity input, Add to Bag button, trust strip, and a tabbed accordion for Description / Ingredients / How to Use / Shipping.
| Feature | Detail |
|---|---|
| Gallery layout | Thumbnail strip (left) + main image. Clicking a thumbnail updates the main image via JavaScript. |
| Variant selector | Button-style variant selector (not a dropdown). Selected variant is highlighted with an active state. |
| Add to bag | AJAX form submission via action="/cart/add" triggering the cart drawer on success. |
| Star rating | Reads from product.metafields.reviews.rating and reviews.rating_count. Requires a ratings metafield or reviews app. |
| Breadcrumb | Collection → Product. Toggle globally via Theme Settings → Advanced → show_breadcrumbs. |
| Accordion tabs | Description, Ingredients (rich text), How to Use, Shipping Info. |
| Mobile sticky ATC | Sticky "Add to Bag" bar shown on mobile once the inline button scrolls off screen. |
| Schema markup | Full Product JSON-LD with name, URL, image, description, SKU, price, and availability. |
Templates
Cart Page
The theme has two cart experiences, switchable via Theme Settings → Advanced → Cart style.
Standard Shopify cart page at /cart. Shows line items with image, title, variant, quantity stepper, and line total. Includes order summary with subtotal, shipping note, and Checkout button.
Opens as a side panel from any element with data-cart-trigger. Fetches /cart.js and renders dynamically. Supports quantity updates and item removal without page reload. Floating Bag button shows live item count.
Templates
Homepage Template
The homepage (templates/index.json) ships pre-configured with a curated editorial layout. The default section order is:
| # | Section | Key Default Content |
|---|---|---|
| 1 | Hero | Stats: 12k+ Happy Devotees · 4.9 Average Rating · 98% Would Recommend · 18 Months of R&D |
| 2 | Marquee Bar | "Clean Beauty · Cruelty Free · Vegan Formulas · Dermatologist Tested · Sustainable Packaging · Rare Botanicals · Gold-Infused · Paraben Free" |
| 3 | Press Logos | Vogue · Elle · Harper's Bazaar · Allure · Marie Claire |
| 4 | Icon Strip | Clean Beauty · Cruelty-Free · Sustainable · Clinically Proven |
| 5 | Collection Tiles | Soft & Glowing Skin (Herbal Face Care) · Silky & Strong Hair (Herbal Hair Care) |
| 6 | Featured Collection | Linked to frontpage collection — 4 products |
| 7 | Featured Spotlight | 24K Gold Radiance Serum — disabled by default, enable in Theme Editor |
| 8 | Image with Text | "Beauty as a daily devotion" brand story |
| 9 | Ritual / Story | 3 ritual steps + 4 value cards |
| 10 | Brand Promise | Dark bg · 4 pillars · 4 stats |
| 11 | Testimonials | 3 reviews + 4 summary stats |
| 12 | Journal Preview | 3 article blocks — Rituals, Ingredients, Wellness |
| 13 | Newsletter | 3 perk chips — 10% Off · Early Access · Expert Skincare Tips |
Snippets
Snippets Reference
Renders an inline SVG by name. Takes name (required) and size (optional, default 24). Contains 35+ custom-drawn icons. Unrecognised names fall back to sparkle.
Renders a star rating row. Takes rating (1–5) and optional size. Used by Testimonials and the Product Page.
Renders a single product card with image, title, price, and a quick-add button. Used by the Featured Collection section. Respects the card_show_ratings and card_show_vendor global settings.
Renders a styled placeholder card when no product image is available. Maintains grid layout consistency.
render 'product-card-placeholder'JavaScript — lumiere.js
Cart Drawer
The AJAX cart drawer is the centrepiece of assets/lumiere.js. It uses event delegation for robustness — any element with data-cart-trigger will open the drawer, and any element with data-cart-close will close it.
| Function / Event | Description |
|---|---|
openDrawer() | Adds .is-open to #cart-drawer, sets aria-hidden="false", adds .drawer-open to body, calls renderDrawer() |
closeDrawer() | Removes classes and resets aria state |
renderDrawer() | Fetches /cart.js, builds HTML for each line item, updates the footer with subtotal and checkout button, syncs FAB and header cart counts |
data-cart-trigger | Attribute on any element (FAB, header bag icon) to open the drawer on click |
data-cart-close | Attribute on overlay and close button to close the drawer |
| Quantity change | Delegated listener on #cart-drawer-body for [data-qty-change] — PATCHes to /cart/change.js and re-renders |
| Escape key | Closes the drawer on keydown Escape |
JavaScript — lumiere.js
Header Scroll Behaviour
The header scroll logic uses an IntersectionObserver to watch the hero section and adds a .scrolled class to #site-header once the hero leaves the viewport, triggering the frosted-glass background.
// Behaviour controlled by .scrolled class on #site-header
// CSS in lumiere.css:
// .site-header.scrolled {
// background: rgba(250,247,242,.85);
// backdrop-filter: blur(12px);
// }
JavaScript — lumiere.js
Scroll Animations
AuraBeauty uses a lightweight IntersectionObserver-based animation system. Elements with the classes below are revealed as they enter the viewport. Animations can be globally disabled via Theme Settings → Advanced → enable_animations.
| Class | Animation | Usage |
|---|---|---|
.animate-up | Translate Y + fade in (0.6s ease) | Hero heading, hero CTA, section cards |
.animate-up--d1 | Same with 100ms delay | Hero heading line 2 |
.animate-up--d2 | Same with 200ms delay | Hero subheading |
.animate-up--d3 | Same with 300ms delay | Hero CTA buttons |
.animate-up--d4 | Same with 400ms delay | Hero stat strip |
.animate-fade | Opacity fade in only (0.8s ease) | Hero product image frame |
prefers-reduced-motion. Users with reduced motion enabled see elements immediately without transitions.
Support
Credits & Support
Name: AuraBeauty Luxury
Version: 2.1.0
Author: Adbeats Media
Platform: Shopify OS 2.0
Preset: AuraBeauty Luxury
Docs: adbeatsmedia.com/themes/aurabeauty/documentation
Support: adbeatsmedia.com/themes/aurabeauty/support
Cormorant Garamond (Google Fonts) — Default headings
Jost (Google Fonts) — Default body & UI
Both switchable via Theme Settings → Typography
AuraBeauty has zero third-party JavaScript dependencies. All functionality is vanilla JS — no jQuery, Alpine, or external libraries required.
AuraBeauty Luxury Theme
v2.1.0 · Adbeats Media · Shopify OS 2.0