Kissa · Theme docs Version 2.0.0 · STUDIO DIGI

Kissa, roasted for Shopify.

Every bag presented like a roaster's lot sheet, with its roast date, freshness window and farm details, plus the tools a coffee shop needs: a roast calendar, a subscription planner, brew guides and a café menu that changes by store.

Support: contato@studiodigi.com.br

Getting started

  1. Add the theme from the Theme Store, then choose Customize.
  2. Set your colors and fonts under Theme settings (see Theme style).
  3. Add your coffees as products. For the lot sheet, freshness bar and roast stamp, create the coffee metafields described in Coffee details.
  4. Create collections for your coffees, seasonal lots and brewing gear, and choose them in the Product showcase section on the home page.
  5. Set your roast and ship days in Theme settings → Coffee. The announcement bar, product pages and cart then show the next roast and the order deadline.

Sections that have no content yet show placeholder artwork in the theme editor, so you can see the layout before you fill it in.

Theme style

Kissa ships with one style, also called Kissa: a roaster's lot sheet in warm paper and ink with a terracotta accent, Work Sans with data set in a monospaced face, square corners and 4:5 product cards. Every color scheme meets WCAG AA contrast for text, secondary text, accent and buttons.

Make it your own under Theme settings: five color schemes, heading and body fonts, corner radius, card shape and the animations.

Coffee details with metafields

Kissa reads coffee details from product metafields. Create them in Settings → Custom data → Products → Add definition, with these exact namespace and keys. All are optional: a missing field is simply not shown.

Shown as Namespace and key Type
Origin (for example "Serra da Mantiqueira") custom.origin Single line text
Process (for example "Natural") custom.process Single line text
Altitude (for example "1,350 m") custom.altitude Single line text
Varietal (for example "Yellow Bourbon") custom.varietal Single line text
Tasting notes custom.tasting_notes Single line text, list of values
Roast level custom.roast_level Integer, 1 to 5
Roast date (freshness and stamp) custom.roast_date Date
Lot (for example "Lot 07") custom.lot Single line text
SCA score (for example "86.5") custom.score Single line text
Recommended brew method (for example "V60") custom.brew_method Single line text
Roaster's brew note custom.brew_note Multi-line text

Freshness

With a roast date, Kissa shows where the coffee is in its life: resting, at its peak or still good, on a bar with today marked. It appears on product cards, on the product page and in the hero. The number of days in each phase is set in Theme settings → Coffee (default: 7 days resting, at its peak until day 28, good until day 45). The page works the phase out on the server, and a small script keeps it current on cached pages.

Theme settings

Home page sections

Product page

Blocks in Product information: vendor, title, price, SKU, tasting notes, roast schedule, freshness, roast meter, origin details, variant picker, subscription planner, buy buttons, description, collapsible tabs, share, custom Liquid and app blocks.

Café pages: stores and menu

To use them, create a page in Online Store → Pages and choose the template.

Other pages

Collection pages with filters and sorting (including color swatch and image filters), search with predictive results, cart page and drawer, blog and article with comments, contact page, customer account pages, 404 page, password page and gift card page, all in the lot sheet style.

Selling features

Accessibility and performance

FAQ

The freshness bar does not show. The product needs a value in custom.roast_date (type Date).

The planner says it cannot read the interval. Name your selling plans with the interval, for example "Delivery every 2 weeks" or "Monthly".

The hero poster shows a photo instead of a floating bag. Add a PNG with a transparent background in the lot's Floating image.

The menu shows no items for a store. Check the store names in each item's Only at these stores field: they must match the store blocks in Menu: stores. Leave the field empty for items served everywhere.

Something else? Write to contato@studiodigi.com.br with your store URL and a screenshot.

Support

Write to contato@studiodigi.com.br. We answer within two business days, Monday to Friday.

To help us answer in one reply, include:

Support covers setting up and using the theme's own features and settings. It does not cover custom code changes, third-party apps or Shopify features outside the theme; for those, the Shopify Help Center is the best place to start.

Credits