Skip to main content

EverShop Theme Development Documentation

Build EverShop themes: theme structure, React templating, styling with Tailwind CSS or SCSS, and the view system that renders your storefront.

Theme Overview

How EverShop themes work: where themes live, how to create, structure and activate one, and the CLI commands for building a custom React storefront.

The View System

How EverShop renders views: React server-side rendering with hydration, module view structure, the Area component and per-component data fetching.

Styling

Style EverShop themes with Tailwind CSS v4, SCSS or plain CSS: how styling works, adding global CSS, and best practices for components and pages.

Templating

Customize EverShop's storefront templates with React: override default components, add new ones with @components aliases, and make your theme translatable.

Images

How EverShop 2.2.1 derives storefront image dimensions from the store's configured catalog aspect ratio, and what a theme must do differently.

Accessibility

Core components carry accessibility behavior that a theme silently reverts when it forks them. This page documents each contract and how to keep it.

Theme Content

How a theme ships its storefront widgets and placements in theme.json, how EverShop versions installs and upgrades, and the full theme CLI reference.

Using Metafields

Declare custom fields in your theme's theme.json and render their values on the storefront with the Metafield component.

Page Builder Primitives

The @components/common/page-builder surface — Editable, widget context, settings scoping, and the two-surface rule that makes list settings crash if you read them naively.