Build a ceramics shop, step by step

Goal: see what you will build in this guide, and in what order.

Who this is for: shop owners and editors. You do not need any technical knowledge. There is one short part for developers at the end.

Time: about 5 minutes to read.

The finished shop page: products in groups — Tea bowls, Vases, Jars and Bowls — each with a photo, a name, a glaze and a price

The story

Clay & Kiln is a small pottery studio. Two potters make tea bowls, vases, jars and bowls by hand. They want a website where people can:

  • see every piece with a photo, a price and a short text,
  • find pieces by group (tea bowls, vases…),
  • order a piece with a simple form.

In this guide you build that website yourself, in the admin, one step at a time. Every step has a picture, so you can check that your screen looks the same.

What you need

  • An admin account on a rustango-cms site that can create pages, page types, menus and settings. If you are not sure, ask the person who manages your site.
  • The 14 example photos. You can download them from the example shop folder. You can also use your own photos.

For developers: the example site is in examples/ceramics_shop. How to start it is written at the top of its main.rs file.

The chapters

Do the chapters in this order. Each one uses what you made in the chapter before it.

Part 1 — The shop window

#ChapterWhat you do
1Your shop's name and coloursType the shop name, the tagline, the colours and the footer text once. Every page uses them.
2Add your photosUpload all photos to the media library in one go.
3The home pageMake the front page with a big photo, a heading and a welcome text.

Part 2 — The products

#ChapterWhat you do
4Make a "Product" page typeDecide which boxes every product has: price, glaze, photo, description. No code.
5Groups of products: categoriesMake the groups Tea bowls, Vases, Jars and Bowls.
6The shop pageMake the page that shows all products.
7Add your productsAdd ten products and put each one in a group.

Part 3 — Help people find things

#ChapterWhat you do
8The main menuBuild the menu at the top of every page: add pages and your own links, change the order, put items inside other items.

Part 4 — Content everywhere, and orders

#ChapterWhat you do
9Reusable textWrite the shipping information once in the Library, show it on an "About us" page and on every product, and change it in one place.
10The order formBuild an order form, put it on the product pages, get each order by email and read the orders in the admin.

Part 5 — Grow

#ChapterWhat you do
11Be found on GoogleWrite SEO titles and descriptions, check the sitemap, rename a page without breaking links, and add your own redirects.
12A second languageAdd French, then translate the pages, the menu, the shipping text and the order form.
13A members areaShow trade prices only to cafés and shops: a role, a private page, sign-up, a friendly "not yet" page and a menu item only members see.
14Work as a teamAdd a helper, check each new product before it goes live, send it back with a note, and review changes to live products.
15A salePrepare a sale page now; the site publishes it at a set time and takes it down again a week later.
16Let an AI agent helpGive an AI assistant a key that can only write drafts, let it add a product, then check and publish it yourself.

For developers

ChapterWhat you learn
Show menus and settings in templatesThe template helpers menu(), auto_menu() and site_setting(), as the shop uses them.
The helper traitsHow the shop's code-made parts work: #[derive(PageType)], PageTypeOverrides, LibraryTypeHandler, TaxonomyHandler and register_site_setting!.
A headless storefrontShow the shop on a second website in plain JavaScript: pages, photos, blocks and the menu from the JSON API.
Preview drafts on your own frontendLet editors see a draft in that website, inside the editor and in a new tab, with a preview token.

Next

Start with chapter 1: Your shop's name and colours.

View or edit this page on GitHub →