File Architecture

How the file
is structured.

Blocks combine to form sections. Sections stack to build pages. Select a layer to see how it works.

Section

Blocks combine to form a section. Each section maps to a Shopify theme section — carrying its own layout, color scheme, and spacing. Mix block types to produce a new section configuration without rebuilding from scratch.

Primary element
Context / container
Section

Block

Block

Section
Headline
Master

Cards

Atoms

Card

Style Variables →

Card →

Content

Testimonial

Product

Article

Brand

Team

Master Container

Types →

Dropdown Menu

Newsletter Signup

Quick Buy

Cart Drawer

Size Guide

Tooltip

Metaobject Overlay

Layer Reference

Every layer,
defined.

01 — Foundation
Variables & Styles

The true foundation. Color tokens, type styles, spacing, radii, shadows — every component in the system references these. Change a token; the update propagates everywhere. Variables are what make the system themeable, not just reusable.

02 — Atoms
Atoms

The smallest named components, built from variables. Buttons, badges, price, review stars, swatch selectors, inputs, labels, image ratios. Each has full variant coverage. Update an atom once; it propagates through every card, section, and container that references it.

03 — Components
Components

Purpose-built assemblies of atoms — a review block, a swatch selector group, a breadcrumb, a quantity stepper. Larger than atoms but not yet a card. Components live in the shared library and are composed into cards and master containers.

04 — Cards
Cards

Master card types assembled from atoms and components: product, collection, blog, recommendation, metaobject, team, testimonial, brand. Every card shares the same slot structure — ratio container, metadata zone, action area. Swap the card type; the block stays intact.

05 — Blocks
Blocks

Blocks combine to form sections. Each block carries a card — mix block types to compose a new section layout without rebuilding. Merchants reorder and toggle blocks in Shopify, and that structure maps directly to the file.

06 — Sections
Sections

Formed by combining blocks. Each section maps to a Shopify theme section with its own layout strategy, color scheme, and spacing. Stack sections to build a full page template.

07 — Pages
Pages

Sections stacked into a complete page template. The file includes 106 pages covering PDP, PLP, Homepage, Collections, Blog, Cart, Checkout, and more — each built from the same block and section system.

08 — Master Containers
Master Containers

A global overlay layer above sections. Hold named slots for metaobjects and purpose-built component sets: dropdown navigation, email signups, tooltips, quick-buy modals, cart drawers. Reference the same atoms as the rest of the system — no separate trees, no duplication.

Ready to see it
in Figma?

Get access to the full file and explore the architecture yourself.