Wish You Were Here

En kodbas, många butiker: tokens, teman och Figma

Jonas
  • Skrivet av Jonas M.
  • 9 november 2026
  • Kunskap
  • 6 min läsning

Webbshoppar skiljer sig i utseende och i några val om hur sidorna fungerar, men sällan i hur de är byggda. Så här kan en och samma kod bära butiker i olika branscher: med tokens, teman, konfiguration och block, och med värdena från Figma.

Den här artikeln är för den som bygger eller beställer en webbshop och vill att nästa butik ska dra nytta av arbetet med den förra. Vilka komponenter en webbshop behöver går vi igenom i Designsystem för e-handel: komponenterna en webbshop behöver. Här handlar det om lagret under komponenterna, med exempel från vår grund för Shopify-butiker: en headless-butik byggd med Hydrogen, Shopifys verktyg för butiker där sidorna är en egen sajt. Grunden har ännu inte släppts till ett kundprojekt, så det som står här är hur den är byggd och testad i vår referensbutik.

Fyra lager skiljer butikerna åt

Det som skiljer två butiker åt går nästan alltid att lägga i ett av fyra lager:

  • Tokens: namngivna värden för färg, typsnitt, avstånd, hörn, rörelse och fokus. De bestämmer hur allt ser ut.
  • Teman: en uppsättning tokenvärden med ett namn. Ett tema byter värden, aldrig komponenter.
  • Konfiguration: val om hur sidorna fungerar, samlade i en fil med typer: hur produktkortet ser ut, var filtren ligger, hur bilderna visas på produktsidan och om logotypen står i mitten.
  • Innehåll: sidorna, som redaktören bygger av block.

Allt annat är gemensamt: sidtyperna, köpflödet, tillgängligheten, sökmotoroptimeringen och lagkraven. För att visa att det håller har referensbutiken två uppsättningar konfiguration, en för inredning och en för mode. Modebutiken har ett annat tema, andra produktkort och en annan layout på kategorisidan och produktsidan, men samma kod, och båda testas sida vid sida i Storybook.

Tokens namnges efter vad de gör

En token heter efter sin roll, inte efter sitt värde: --color-bg, --color-fg-muted, --color-accent och --color-sale, aldrig något som --blue. Då kan ett tema göra bakgrunden beige och accenten rostbrun utan att ett enda namn blir fel.

Komponenternas CSS får bara använda tokens. Det kontrolleras med Stylelint, som stoppar hexfärger, färgfunktioner som rgb() och råa värden för avstånd och hörn. Ett värde som skrivits direkt i en komponent blir kvar när temat byts.

Vilka tokens som behövs visar sig när en ny butik inte går att uttrycka med dem som finns. När referensbutiken skulle få små versala sektionsrubriker, logotypen i mitten och produktbilder på en tonad yta blev det nya tokens, med standardvärden som gav exakt samma utseende som tidigare.

Ett tema är en uppsättning värden

Ett tema är en CSS-fil som bara innehåller de tokens som skiljer sig från standardtemat. Det väljs i konfigurationen och sätts som attributet data-theme på sidans html-element. Ordet tema betyder alltså något annat här än ett tema i Shopifys temabutik. Så här ser det varmare av referensbutikens två teman ut, i ett utdrag:

css
@layer tokens {
  :root[data-theme='warm'] {
    --color-bg: #faf6f0;
    --color-fg: #2b2118;
    --color-accent: #8a3b12;
    --font-heading: georgia, 'Times New Roman', serif;
    --radius-md: 4px;
  }
}
Ett utdrag ur ett tema: bara värden, inga komponenter.

Standardtemat är medvetet neutralt: svart, vitt och grått, systemets typsnitt och raka hörn. När ett tema laddar ett eget typsnitt får reservtypsnittet justerade mått, bland annat med size-adjust, så att texten inte flyttar sig när det riktiga typsnittet har laddats.

CSS Modules och vanlig CSS

Komponenternas stil ligger i CSS Modules, en CSS-fil bredvid varje komponent som följer med paketet när det installeras. Vi valde bort Tailwind, som inte läser paket i node_modules av sig själv och där ett tema hade bytt klasser i HTML-koden i stället för värden i en fil.

Tre delar av vanlig CSS gör mest nytta här. Alla tre räknas på MDN som Baseline widely available, alltså har de fungerat i alla stora webbläsare i flera år:

  • @layer bestämmer i vilken ordning reglerna gäller: reset, tokens, base, components, utilities och overrides. En butik som behöver ändra en komponent gör det i overrides, som vinner över de andra lagren, utan !important och utan att röra paketens CSS.
  • Nesting låter tillstånd och varianter stå inne i komponentens regel, så att filen läses i samma ordning som komponenten.
  • Container queries låter ett block anpassa sig efter bredden på ytan det står i, i stället för skärmens. Samma produktrad kan då stå i full bredd på startsidan och i en smal kolumn på en kampanjsida.

Kontrasten kontrolleras för varje tema

När utseendet är fritt att ändra är kontrasten det som först går sönder. Därför finns en lista över de tokenpar som används ihop, som text på bakgrunden, text på accentfärgen, rea-priset och kantlinjer på fält. Ett skript räknar ut kontrasten för varje par i varje tema, och bygget stoppas om ett par inte klarar kravet.

Kraven är WCAG:s: minst 4,5:1 för text och minst 3:1 för kantlinjer, ikoner och andra delar av gränssnittet. Ett tema ärver allt det inte deklarerar, så skriptet kontrollerar alltid temat tillsammans med standardvärdena. Text ovanpå bild går inte att kontrollera på samma sätt, eftersom bilden väljs av redaktören. Där lägger komponenten en mörk ton bakom texten, och den tonen kontrolleras mot en helt vit bild.

Kontrasten är en del av tillgängligheten, inte hela. Vad lagen kräver av en webbshop står i Tillgänglighetslagen och din Shopify-butik, och kraven i WCAG förklaras i Vad är WCAG?

Från Figma-variabler till CSS

För designern är tokens variabler i Figma. Vårt Figma-bibliotek är byggt från koden, med alla tokens som variabler och ett läge (mode) per tema. Figma bestämmer värdena, och koden bestämmer namnen och strukturen.

Formatet mellan dem är DTCG, från Design Tokens Community Group, en community group hos W3C. Den första stabila versionen, 2025.10, publicerades i oktober 2025 som gruppens slutrapport. Det är ingen W3C-standard, men ett gemensamt format för tokens i JSON. Figma kan exportera ett läge som JSON och läsa in variabler i DTCG-format. En färg ser ut så här:

json
{
  "color": {
    "$type": "color",
    "bg": {
      "$value": {"colorSpace": "srgb", "components": [1, 1, 1], "hex": "#ffffff"}
    }
  }
}
Variabeln color/bg i DTCG-format. Den blir --color-bg i CSS.

Importen görs av ett eget skript i stället för ett externt verktyg som Style Dictionary:

  • Variabeln color/bg blir --color-bg. Figmas standardläge skrivs till standardtemat och varje annat läge till sitt eget tema. Bara tokens som redan finns i koden ändras, och en variabel som saknas där listas och hoppas över.
  • Enheten kommer från koden. Figma anger storlekar i pixlar, men koden använder rem, så att allt växer med den textstorlek besökaren har valt. 16 px från Figma blir därför 1rem.
  • Kontrasten kontrolleras innan något skrivs, och klarar ett par inte kravet avbryts importen.

Det finns gränser. Text som växer med skärmen, med clamp(), går inte att uttrycka som ett tal i Figma och får skrivas in som text. Och vi har ännu inte provat importen mot en fil från Figmas egen export, så den kan behöva justeras.

Sidor av block med scheman

Innehållssidorna är listor av block: hero, produktrad, kategoriplattor, text och bild, frågor och svar, sammanlagt 24 stycken. Det är våra egna block och inte blocken i ett Shopify-tema, men tanken är densamma: redaktören bygger sidor av färdiga delar. I referensbutiken läggs blocken och innehållet in i Shopify som metaobjekt.

Varje block har ett schema som beskriver vilka fält det tar och vad som är giltigt, och alla block har samma inställningar för avstånd, bakgrund, bredd, i vilka marknader de syns och mellan vilka tidpunkter. Är ett block okänt eller dess fält ogiltiga loggas det och hoppas över, och sidan visas ändå. Ett fel i en kampanj tar alltså inte ned startsidan.

Vad det betyder för butiken

Det vanliga sättet att återanvända en butik är att kopiera den, men då måste varje förbättring föras över för hand, och kopiorna glider isär. Vår grund är i stället delad i paket med versionsnummer, där varje ändring beskrivs i en ändringsfil (changeset), men paketen har ännu inte getts ut i en första version.

För den som beställer butiken betyder det att nästa butik inte börjar från noll, och att en förbättring i en butik kan nå de andra. För designern blir ett nytt tema mest arbete med variabler i Figma, med kontrasten kontrollerad innan värdena når koden.

Det kräver också disciplin. En butik som vill något som strukturen inte rymmer kan inte bara ändra i en komponent, utan ändringen behöver göras så att den passar alla. Om en headless-butik eller ett vanligt tema passar er butik bäst går vi igenom i Headless eller tema på Shopify 2026: när det lönar sig.

Vad ska vi göra tillsammans?

Kontakt

hello@wishyouwerehere.se