Skip to content
New Webhooks added: Inventory and Order modifications. Check the changelog →
Cartly Developers

Clarity Theme

Clarity is Cartly's editorial default theme — filter-rail PLP, sticky PDP, AJAX Quick-Add, wishlist, Customer Account on Liquid, and full i18n across 7 locales.

Overview

Clarity is the canonical reference theme registered in the marketplace as theme-clarity. It is featured on the AppStore themes home page. New shops see Clarity in the AppStore; Linen is the onboarding install template.

Architecture

Source: backend/internal/theme/templates/themes/clarity/. Three-layer resolver: DB fork → embed FS → boilerplate FS. Fork-on-write: a DB row is created only when a merchant edits a file.

Key Sections

  • main-collection.liquid — filter-rail PLP with Typesense facets, sort, active-filter chips, pagination
  • main-product.liquid — sticky-info PDP with media gallery
  • bundle-items.liquid — bundle section on PDP
  • product-reviews.liquid — review list and submission form
  • recently-viewed.liquid — client-side carousel (localStorage)
  • main-search.liquid — search results with filter rail
  • main-article.liquid — blog article with related-articles band
  • main-404.liquid — themed 404: two-column hero plus help-links band

Design Tokens

CSS custom properties in assets/theme.css. Primary: #1a1a2e, accent: #c9a96e (warm gold), fonts: Playfair Display + Inter.

i18n

All customer-facing strings use {{ 'key' | t }}. Seven locales: en, de, es, fr, ru, uk, he.

Customer Account on Liquid

Clarity ships all 28 customer account templates under customers/, rendering /account/* routes in its own design language. Full Clarity Theme guide →