Welcome

Documentation for the MigreLief Shopify theme — what each section and block does, every setting it exposes, and the conventions the build follows.

Who this is for

Content editors working in the Shopify theme customizer: start with the Section Reference to understand what each section does and which settings matter.

Developers picking up the theme: read Theme Architecture first, then Conventions before writing anything.

How these docs stay current

Docs are written as part of the work, not after it. When a section or block is added or meaningfully changed, its page here is updated in the same commit. That rule lives in the repo’s CLAUDE.md, so it applies to any agent-assisted work as well as human work.

See Keeping Docs Current for the workflow, and the Docs Backlog for what still needs writing.

Coverage is partial

This site was scaffolded partway into the build. Sections and blocks completed before that point are listed in the backlog and still need documenting — a page’s absence means it hasn’t been written yet, not that the feature doesn’t exist.

Running the docs locally

cd docs-site
npm install
npm run dev      # http://localhost:4321

Command	What it does
npm run dev	Local dev server with hot reload
npm run build	Production build into dist/
npm run preview	Serve the production build locally
npm run check	Type-check content and config
npm run deploy	Build and deploy to Cloudflare Pages

The site is set to noindex, nofollow — it’s internal documentation and should stay out of search results.