Shopify Themes For Developers


Shopify themes for developers - 1st edition (2021)

  • An 18-page book to understand the structure and the content of a Shopify theme, in less than 1 hour.
  • Authors: Coralie Delpha and Dimitri Alamkan.
  • Format: a .zip file containing 7 PDFs (1 PDF per chapter).
  • Release date: March 20th, 2021 (1st edition).


Why did we write this book?


  1. The Shopify documentation is spread over too many different resources: country-based Shopify blog articles, the official documentation at shopify.dev, more information at shopify.com/partners. As developers, we wanted to have a centralized document: the "1 ring to rule them all" type of vibe.
  2. The Shopify documentation does not provide enough context and enough examples on how Shopify themes really work. We wanted to make an opinionated guide with simple and explicit explanations. We gave some well-deserved perspective and hierarchy to information related to Shopify themes.

Table of contents


1 | Shopify themes and Separation Of Concerns (SOC)

1.1 | SOC and front-end files
1.2 | 50 shades of SOC
1.3 | The first limitation of HTML
1.4 | The second limitation of HTML


2 | The Liquid language

2.1 | What is Liquid?
2.2 | Learning Liquid
2.3 | Our comments about Liquid


3 | Structure and content of a Shopify theme

3.1 | What is a Shopify theme?
3.2 | How can we see the directories of a Shopify theme?
3.3 | The flat directories
3.4 | The cascading directories (Overview)


4 | The cascading directories (Details)

4.1 | Level 1: the templates directory
4.2 | Level 1: the layout directory
4.3 | Level 2: the sections directory
4.4 | Level 3: The snippets directory
4.5 | Level 4: the assets directory


5 | Objects available to the theme files


6 | Theme Kit: a tool for Shopify theme development

6.1 | What is it for?
6.2 | What do you need to make it work?
6.3 | The commands to install Theme Kit
6.4 | The commands to use Theme Kit


7 | Conclusion