Tillbaka

Designsystem

Designsystem som faktiskt skalar

Tokenarkitektur, namngivning och dokumentation — lärdomar från system byggda för team i tillväxt.

28 apr 2026 · 8 min läsning

Ett designsystem är inte en Figma-fil med komponenter. Det är ett levande avtal mellan design och utveckling om hur produkten ska se ut och bete sig — nu och om tre år när teamet är fyra gånger så stort. Att bygga ett system som håller kräver mer disciplin än de flesta räknar med.

Tokens är fundamentet

Allt börjar med design tokens — de abstrakta värdena som representerar dina designbeslut. Inte "#1a1a1a" utan "color.text.primary". Inte "16px" utan "spacing.md".

Varför abstraktionen? Därför att när du byter från ljust till mörkt tema, eller när din primärfärg ändras efter en rebrand, vill du ändra ett värde på ett ställe — inte jaga hexkoder genom hundratals komponenter.

Token-hierarkin vi rekommenderar: globala tokens (råvärdena) → semantiska tokens (vad de betyder) → komponenttokens (specifika användningar). En primärknapp använder "button.background.primary" som pekar på "color.brand.500" som pekar på "#6366f1".

Namngivning är viktigare än du tror

Dålig namngivning dödar designsystem. Vi har sett system med komponenter som heter "CardNew2", "ButtonV3Final" och "ModalFixed". När ingen vet vad komponenterna heter används de inte — och om de inte används existerar de inte i praktiken.

Principerna vi följer: beskriv vad det är, inte hur det ser ut. "PrimaryButton" > "BlueButton". Använd konsekvent ordning: komponent + variant + tillstånd. "ButtonPrimaryLarge", "ButtonSecondaryDisabled". Och dokumentera varför — inte bara vad.

Komponenter som faktiskt används

De flesta designsystem har för många komponenter. Teamet bygger ett komplett bibliotek, lanserar det med fanfarer, och sex månader senare designar folk fortfarande egna varianter i sidofiler.

Anledningen är nästan alltid att komponenterna inte täcker verkliga behov. Lösningen: börja med inventering. Vilka UI-mönster finns faktiskt i produkten idag? Vilka upprepas? De är dina första komponenter.

Bygg inget i förväg. Varje komponent som läggs till i systemet utan ett konkret behov är en komponent som måste underhållas utan att ge värde tillbaka.

Dokumentation som faktiskt läses

Dokumentation som inte läses är lika värdelös som ingen dokumentation. Det vanligaste misstaget är att dokumentera hur komponenter fungerar utan att förklara när de ska användas.

Varje komponent behöver: ett tydligt syfte ("Använd denna för primära handlingsuppmaningar, max en per vy"), konkreta do/don't-exempel, och en lista på de vanligaste misstagen vi sett i verkligheten.

Vi föredrar Storybook för teknisk dokumentation och Notion för designriktlinjer. De pratar om olika saker till olika publiker.

Governance — vem äger systemet?

Det tekniska arbetet är egentligen det enkla. Det svåra är governance: vem bestämmer vad som kommer in i systemet? Hur hanteras bidrag från team som vill ha en variant som inte finns? Vem granskar Pull Requests mot systemet?

Utan tydliga svar på de frågorna blir systemet antingen ett diktatoriskt hinder (ingen använder det) eller ett demokratiskt kaos (ingen litar på det).

Vår rekommendation för team under 30 personer: en "system owner" med slutgiltig beslutanderätt, ett öppet bidragsflöde med en tydlig process, och ett veckovisa synkmöte på 30 minuter.

Versionering och migration

Versioner är oundvikliga. Hur hanterar du breaking changes utan att lamslå produktteamen?

Semantic versioning (major.minor.patch) ger tydliga signaler. Vi rekommenderar alltid en deprecation-period på minst en sprint innan en komponent tas bort, med automatiska linting-varningar för utfasade komponenter.

Migration-guides är inte valfria — de är en del av releasen. En guide som visar det exakta sök-och-ersätt-mönstret för en breaking change tar en halvtimme att skriva och sparar teamet dagar.

Ett designsystem är en investering som lönar sig långsamt och dramatiskt. De första tre månaderna känns som merarbete. Vid tolv månader är det er produktivitetsmultiplikator. Vid tre år är det anledningen ni kan iterera snabbare än konkurrenterna.