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.

The homepage is a JSON template — templates/index.json — that composes six sections in a deliberate order. The rhythm runs from cinematic wide shot to product close-up to category index to merchandising vignette to editorial chapter to membership invitation. Each section is independent. Reorder them. Hide them. Add others alongside. The structure exists to be edited.

​
Default order

#SectionTypeDefault purpose
1herohome-heroFull-bleed video / poster carousel with overlay copy + dual CTAs. Up to 8 slides.
2new-arrivalshome-new-arrivalsScript-headed product grid pulled from a chosen collection.
3archivehome-category-archiveDark navy band with six collection tiles.
4bundlehome-bundle”Worn together” hotspot picker on a stage image.
5chaptershome-chaptersTwo-up full-width editorial tiles.
6clubhome-clubMembership / community CTA over a full-bleed image.

​
Section-by-section

​
1. Hero

A full-bleed slideshow that stages the season. Each block is one slide — eyebrow line, headline script, headline sans, fallback Unsplash image, CTA label, CTA URL. The default ships with two slides (“The long voyage.” and “On the Riviera.”), but the section supports up to eight. Section-level settings:
  • plate_line — small caption rendered over the slide (default: GENOVA · SUMMER MMXXVI).
  • slide_ms — slide duration in milliseconds (default: 6500).
Replace fallback_unsplash_id with a real image_picker upload via the Theme Editor. The Unsplash IDs only show through if no merchant image is set.

​
2. New arrivals

The first product moment on the page. A script accent (“New Arrivals” by default) sits above a four-card grid pulled from a chosen collection. The default config uses the new collection handle and limits to four products. 
"new-arrivals": {
  "type": "home-new-arrivals",
  "settings": {
    "script": "New Arrivals",
    "collection": "new",
    "product_limit": 4
  }
}

​
3. Category archive

A dark navy band that interrupts the page rhythm — six collection tiles in a flowing layout. Each tile is a block of type category with a collection reference, fallback_title, fallback_count, fallback_url, and fallback_unsplash_id. The fallbacks render only when the referenced collection is missing or empty. The default six tiles cover Shirts, Trousers, Shorts, Knitwear, Outerwear, and Accessories.

​
4. Bundle

The “Worn together” moment. A single full-bleed stage image with up to four hotspots — each hotspot pinned by x / y coordinates (percentages), side preference (left / right), and a referenced product. The customer can build a complete look from a single image, then add the lot to cart with one click. Section settings:
  • script — heading accent (default: Worn Together).
  • list_multiplier — tunes the bundled total preview (default: 112).
  • fallback_unsplash_id — the stage photo.
Each hotspot block carries x, y, side, default (whether it’s pre-selected), fallback_name, fallback_price, and fallback_unsplash_id.

​
5. Chapters

A two-up moment — typically used to split the catalog by audience or by silhouette. Each block is a chapter with a script label, CTA, link, and fallback image. The default ships with “Top Wear” and “Bottom Wear”. The section-level heading setting (default: Men's Wardrobe) sits above the two chapters as a frame.

​
6. Club

A full-bleed editorial image with overlay copy and a single CTA. By default, it’s a membership invitation: 
"club": {
  "type": "home-club",
  "settings": {
    "title": "Join Voyager Club",
    "copy": "Early access to each season's edition, private invitations…",
    "cta_label": "Become a Member",
    "cta_url": "/account/register"
  }
}
Swap the copy for a community sign-up, a press feature, or a closing image.

​
Reordering sections

In the Theme Editor, drag any section in the left sidebar to a new position. The JSON order array updates automatically — you never need to edit templates/index.json by hand. The default order: 
"order": ["hero", "new-arrivals", "archive", "bundle", "chapters", "club"]

​
Adding standalone sections

Voyager’s homepage accepts any section that allows the index template in its presets group. Click Add section in the Theme Editor’s home view and you’ll see:
SectionUse it for
Image bannerFull-bleed image with overlay copy and CTA
Multicolumn2–4 columns of icon + heading + body
Rich textEditorial paragraph + button
SlideshowGeneric carousel (independent of home-hero)
VideoNative or YouTube/Vimeo embed
TestimonialsTwo- or three-up press quote tiles
Featured collectionGeneric version of new-arrivals
Featured productA single PDP-style product preview
Collection listTile grid of merchant-chosen collections
Logo listPress / partner logos
NewsletterStandalone email capture
Blog postsThree-up article preview
Image with textSide-by-side image + copy + CTA
Custom LiquidApp snippets, custom HTML
The six default sections (home-*) are intentionally homepage-only — they don’t appear in the Add section library on other templates. Use the generic sections above when you want similar layouts on product or collection pages.

​
What’s next

Hero section

Every setting on the home-hero section — slides, plate line, slide duration.

Sections overview

Every section Voyager ships with.