Skip to main content

Documentation Index

Fetch the complete documentation index at: https://voyage-theme.fasil.in/llms.txt

Use this file to discover all available pages before exploring further.

This page is a complete transcription of config/settings_schema.json. Every group, every setting, every default — in the same order as the file. Use this as a quick lookup; the live Theme Editor will always be the canonical place to make edits.

Theme info

The first object in the schema is informational metadata, not a setting group. It tells Shopify and the Theme Editor what to display as the theme’s identity.
KeyValue
theme_nameVoyager
theme_version1.0.0
theme_authorDibolky FZC
theme_documentation_urlhttps://voyage.theme/docs
theme_support_urlhttps://voyage.theme/support
Logo (default / navy variant).
logo_white
image_picker
Logo (light variant for dark backgrounds). Used on the transparent home-hero header and any dark-band section.
logo_width
range
default:"140"
Logo width on desktop. Min 60, max 320, step 10, unit px.
favicon
image_picker
Square PNG or SVG. Will be cropped to a 32×32 square.

Colors

Brand palette

color_primary
color
default:"#002F5B"
Primary (ink) — used for body text, primary buttons, hairlines.
color_secondary
color
default:"#F6F4EF"
Secondary (paper) — the default page background.
color_accent
color
default:"#C39738"
Accent — used sparingly for editorial flourishes.
color_muted
color
default:"#565E6B"
Muted text — secondary copy, captions, tiny-num annotations.

Scheme 1 — Default (page)

scheme_1_bg
color
default:"#F6F4EF"
scheme_1_fg
color
default:"#002F5B"

Scheme 2 — Inverse (navy)

scheme_2_bg
color
default:"#002F5B"
scheme_2_fg
color
default:"#F6F4EF"

Scheme 3 — Soft (warm cream)

scheme_3_bg
color
default:"#EFE9DC"
scheme_3_fg
color
default:"#0A0F18"

Scheme 4 — Deep (charcoal)

scheme_4_bg
color
default:"#0A0F18"
scheme_4_fg
color
default:"#F6F4EF"

Functional

color_success
color
default:"#2E7D32"
color_error
color
default:"#B00020"
color_rule
color
default:"#E5E2DA"
Rule / hairline color. Used for dividers and faint borders.

Typography

Body

font_body
font_picker
default:"assistant_n4"
Body font.
font_body_scale
range
default:"100"
Body size as a percentage. Min 90, max 130, step 5, unit %.

Headings

font_heading
font_picker
default:"playfair_display_n4"
Heading font.
font_heading_scale
range
default:"110"
Heading size as a percentage. Min 90, max 160, step 5, unit %.

Accent / script

font_accent
font_picker
default:"playfair_display_i4"
Accent font (italic / script). Used for the editorial accents — script headings, color labels, signatures.

Buttons

button_style
select
default:"solid"
Default button style. Options:
  • solid — solid background, contrasting label
  • outline — transparent background, ink border
  • underline — text-only with an underline
button_corner_radius
select
default:"0"
Corner radius. Options:
  • 0 — Sharp
  • 2 — 2 px
  • 4 — 4 px
  • 8 — 8 px
  • 999 — Pill
button_letterspacing
select
default:"extra"
Letter-spacing. Options:
  • normal — 0.02em
  • wide — 0.12em
  • extra — 0.22em (editorial)

Layout

container_width
select
default:"1280"
Container width. Options:
  • full — 100%
  • 1440 — 1440 px
  • 1280 — 1280 px (default)
  • 1024 — 1024 px
section_spacing
select
default:"comfortable"
Section spacing. Options:
  • compact — 48 px section padding
  • comfortable — 80 px (default)
  • spacious — 120 px
rule_style
select
default:"thin"
Rule / divider style. Options:
  • thin — 1 px
  • medium — 2 px
  • double — 3 px

Cards

card_image_ratio
select
default:"portrait"
Product card image ratio. Options:
  • portrait — 4:5
  • square — 1:1
  • landscape — 4:3
card_text_alignment
select
default:"left"
Product card text alignment. Options:
  • left
  • center
card_show_quickview
checkbox
default:"true"
Show quick-view hover button on product cards.
card_show_wishlist
checkbox
default:"true"
Show wishlist hover button on product cards.
card_show_vendor
checkbox
default:"false"
Show product vendor beneath the title.

Cart

cart_type
select
default:"drawer"
Cart type. Options:
  • drawer — slides in from the side
  • page — full cart page
  • notification — popup on add
cart_show_notes
checkbox
default:"true"
Show order notes field in the cart.
cart_show_discount_codes
checkbox
default:"true"
Show discount code field.

Animation

animations_reveal
checkbox
default:"true"
Reveal animations on scroll.
animations_hover
checkbox
default:"true"
Image zoom on hover.
animations_blur
checkbox
default:"true"
Image blur-to-clear on scroll.

Editorial premium effects

show_cursor
checkbox
default:"true"
Custom cursor — uses the data-cursor attribute on interactive elements.
show_grain
checkbox
default:"true"
Film grain overlay across the viewport.
show_intro_loader
checkbox
default:"true"
Intro loader — the navy curtain that rises on first visit.
click_sounds
checkbox
default:"true"
Click sounds on primary CTAs.

Social media

Instagram URL.
Facebook URL.
Pinterest URL.
TikTok URL.
YouTube URL.
X / Twitter URL.
LinkedIn URL.
Threads URL.

Currency

show_currency_codes
checkbox
default:"false"
Show currency codes (e.g. USD next to price). Adds the ISO code next to formatted prices. Helps multi-market shoppers identify the currency at a glance.
search_predictive
checkbox
default:"true"
Show predictive search dropdown.
search_show_collections
checkbox
default:"true"
Include collections in predictive results.
search_show_articles
checkbox
default:"false"
Include articles in predictive results.
search_show_pages
checkbox
default:"false"
Include pages in predictive results.

What’s next

CSS tokens

Every --custom-property derived from these settings.

Section schemas

Settings and blocks count for every section.