Sundsvall DS · ReferensDagens designsystem, @sk-web-gui 3.1.3
Läge
Ett filter som liknar en TV som tappar ljusa toner.
Referenspunkt

Dagens designsystem, som utgångsläge.

Sundsvalls kommuns nuvarande designsystem heter @sk-web-gui. Det är öppen källkod, publiceras på npm och dokumenteras för människor och AI-agenter på ui.sundsvall.dev. Den här sidan är inte ett alternativ. Den är utgångsläget: det som faktiskt används i kommunens tjänster i dag, och det som alternativen A, B och C ska mätas mot, med samma verktyg och samma måttstock.

Ingenting här är ritat för hand. Varje komponent är renderad av det riktiga React-paketet @sk-web-gui/react 3.1.3 till statisk HTML, all CSS är byggd med paketets egen Tailwind-preset ur @sk-web-gui/core 4.6.2, och färgvariablerna är genererade av samma funktion som paketet kör i webbläsaren, ur @sk-web-gui/theme 2.7.2. Sidan är en stillbild av systemet vid ett datum, inte en implementation; portalens egen regel är att tjänster ska importera paketen, inte kopiera värden.

Var det finns

Portal: ui.sundsvall.dev med varje sida även som markdown och en llms.txt. Storybook: stilguide.sundsvall.se. Kod: github.com/Sundsvallskommun/web-shared-components. Paket: @sk-web-gui/react, core, theme och ett trettiotal komponentpaket.

Hur det används

React-komponenter med props som color="vattjom" och variant="secondary", ett Tailwind-preset som ger klasser som bg-vattjom-surface-primary, och CSS-variabler som --sk-colors-vattjom-surface-primary-DEFAULT. En GuiProvider sätter variablerna och växlar mellan ljust och mörkt.

Vad alternativen förhåller sig till

Det är komplett och i drift: 66 komponenter och 19 AI-komponenter, formulär, tabeller, datumväljare, kakor, användarmeny. Det bär profilens fyra färger som teman och har mörkt läge. Det saknar ett högkontrastläge, kontrastregler för kanter och ytor, och en regelbok med testbara påståenden.

Principer

Systemet uttalar få principer i ord. De som finns är hämtade ur portalens sidor "För AI-agenter", "Tokens", "Tillgänglighet" och "Tonalitet".

Bygg aldrig om designsystemet lokalt

Paketen är implementationen, portalen är dokumentationen. Hex-värden, egna CSS-variabler och HTML-imitationer är förbjudna i tjänster. En sida utan byggprocess ska säga att den inte är produktionsmässig.

Tokens är källan till sanning

Färger, typografi, avstånd, radier och brytpunkter definieras i @sk-web-gui/theme och kompileras till CSS-variabler. Aldrig hårdkodad färg eller storlek.

Fyra varumärkesteman, fyra statusfärger

Vattjom, Grönsta, Juniskär och Björnstigen har samma struktur: background 100–300, surface primary och accent med hover, text default, primary och secondary. Success, warning, error och info följer samma mönster.

Semantiska storlekar

Typografin är semantisk, inte numerisk: display-1, h1 till h4, lead, base, large, small, label. Komponenterna väljer storlek per brytpunkt själva.

Svenska, du-tilltal, verb i imperativ

Knappar säger "Skicka ansökan", aldrig "OK". Länktext beskriver målet. Felmeddelanden säger vad som är fel och vad du kan göra.

WCAG 2.2 AA

Tangentbord för allt, synligt fokus, kontrast 4,5:1, synlig label på alla fält, fel knutna med aria-describedby, aldrig div med onClick, aria-label på ikonknappar.

Färg

Sju primitiva skalor i tio steg, hämtade ur packages/theme/src/colors.ts. Profilens färger ligger som steg 700: blue #005595 (Vattjom), green #00733b (Grönsta), purple #5b1f78 (Björnstigen), pink #a90074 (Juniskär). Orange och red är tillägg för warning och error; gray är neutralerna.

Primitiver

blue 50
100
200
300
400
500
600
700
800
900
green 50
100
200
300
400
500
600
700
800
900
purple 50
100
200
300
400
500
600
700
800
900
pink 50
100
200
300
400
500
600
700
800
900
orange 50
100
200
300
400
500
600
700
800
900
red 50
100
200
300
400
500
600
700
800
900
gray 0
50
100
200
300
400
500
600
700
800
900

Teman och status

Varje tema mappar primitiverna till roller. Ljust läge: surface primary är steg 700 (Vattjom #005595) med text-secondary steg 100 som knapptext, surface accent är steg 200 med text-primary steg 800. Mörkt läge vänder på det: surface primary blir steg 200 och texten steg 800. Statusfärgerna använder steg 600 som knappyta. Dessutom finns ett "inverted"-lager som ger varje komponent sina motsatta färger på mörk platta.

Tabell 1: temaroller i ljust läge
Temasurface primarysurface accenttext primarytext secondarybackground 100 / 200 / 300
Vattjomblue 700blue 200blue 800blue 100blue 50 / 100 / 300
Grönstagreen 700green 200green 800green 100green 50 / 200 / 300
Björnstigenpurple 700purple 200purple 800purple 100purple 50 / 100 / 300
Juniskärpink 700pink 200pink 800pink 100pink 50 / 100 / 300
Successgreen 600green 200green 800green 100green 50 / 100 / 300
Warningorange 600orange 200orange 800vitorange 50 / 100 / 300
Errorred 600red 300red 800vitred 50 / 100 / 300
Infoblue 600blue 200blue 800blue 100blue 50 / 100 / 300

Neutralerna: brödtext gray 900 (#1F1F25), dämpad text gray 700, sidbotten vit, ytor gray 50 och 100. Kanter och avdelare är halvtransparenta lager ("overlay darken") av #1C1C28 i 4 till 95 procent, inte fasta färger. Fokusringen är #0C8CED, en färg utanför profilen.

Typografi och form

Typsnitt

Raleway för rubriker, display och knappar, Arial för brödtext, formulär och navigering. Paketet laddar inte Raleway; applikationen gör det, och utan den faller allt tillbaka på Arial.

Semantiska storlekar

Tabell 2: typografisk skala
TokenVärdeAnvänds till
display-18rem (80 px)Hero och landningssida
h14rem (40 px)Sidans huvudrubrik
h23.2rem (32 px)Sektionsrubrik
h32.6rem (26 px)Underrubrik
h42.4rem (24 px)Mindre rubrik
lead2rem (20 px)Ingress
base / large / small1.6 / 1.8 / 1.4remBrödtext, större brödtext, metadata
label sm–lg1.2–1.8remFormuläretiketter

Rum, radie, skugga

Rotens font-size är 62,5 %, så 1rem = 10 px. Avståndsskalan går i steg om 0,1rem från 0 till 10rem, med namn efter pixelvärdet: spacing-16 är 1,6rem. Radier: knappar 1,2rem (pillerform i praktiken), kort och fält egna värden. Tre skuggnivåer, 50, 100 och 200, plus en inre ring för fokus.

Brytpunkter: phone 320, small-device 480, medium-device 768, large-device 1024, desktop 1366 px. Komponenterna byter storlek på rubriker per brytpunkt.

Exempel: radie på yta och knapp, samt skuggnivå 50 och 200.

Komponenter

Ett urval av de 66 komponenterna, renderade av paketet. Knappar och fält i exemplen är riktiga element men utför ingenting.

Button

Exempel: varianterna primary, secondary, tertiary, ghost och link; färgerna primary, Vattjom, Grönsta, Björnstigen, Juniskär, info, success, warning och error; storlekarna sm, md och lg, samt rounded, disabled och inverted. Knapparna är pillerformade och texten är Raleway fet.

Link

Läs mer på sidan om skolskjuts eller sundsvall.se.

Exempel: länk i löptext och extern länk med ikon.

Alert

Du behöver e-legitimation
Logga in med BankID eller Freja för att fortsätta.
Ansökan är inskickad
Du får svar inom tio arbetsdagar.
Utkastet sparas i 30 dagar
Därefter tas det bort automatiskt.
Bilagan kunde inte laddas upp
Filen är större än 10 MB. Försök med en mindre fil.
Exempel: typerna info, success, warning och error med ikon, rubrik och beskrivning. Typen bärs av kantfärg, ikon och rubriktext.

Badge, Label, Chip, Callout

31299Ny
Mottaget
Komplettering behövs
Beviljat
Avslag
Utkast
Vattjom Grönsta Warning Error
Exempel: Badge med räknare, Label med status i temafärg, Chip med borttagningsikon, och Callout, en färgprick utan text. Callout bär betydelse enbart med färg och ska alltid stå intill text. Chip finns även i inverted-utförande för mörk platta; det visas inte här eftersom det inte är läsbart på ljus botten.

Card och MetaCard

Skolskjuts
Ansök om skolskjuts för ditt barn.
Kort som länk
Neutral botten, hela kortet är en länk.
Nyhet
Nya regler för skolskjuts från hösten.
Exempel: kort i Vattjom, kort som länk med neutral botten, och MetaCard i Grönsta. Ett kort med länk är ett enda a-element med pilknapp som dekoration. Det färgade kortet sätter ingen egen textfärg: brödtextens mörka färg hamnar på Vattjom-blått (1,5:1 i ljust läge) och vit text på ljusblått i mörkt läge (1,6:1). Med länk tar länkfärgen över i stället (1,2:1). Det ser ut som ett fel i paketet och står kvar här som det är.

Formulär

Personnumret behöver vara 12 siffror (ÅÅÅÅMMDDXXXX).

Högst 500 tecken. Skriv inte personnummer här.

Exempel: FormControl med FormLabel, Input, Select, Textarea, FormHelperText, FormErrorMessage och DatePicker. Felet får aria-invalid och kopplas med aria-describedby; ikonen är dold för hjälpmedel och texten bär felet.
Exempel: Checkbox.Group, RadioButton.Group med role="radiogroup", Switch, SearchField, Combobox med role="combobox" och FileUpload.

Table

ÄrendeGällerStatusUppdaterad
SBK-2026-0412Skolskjuts, Elias
Beviljat
15 sep 2026
BYG-2026-1188Bygglov, garage
Handläggs
11 sep 2026
MIL-2026-0071Eldstad
Komplettering behövs
9 sep 2026
Exempel: tabell med bakgrund och tre ärenden. Statusen bärs av Label med text. Tabellen ligger i en egen rullbar behållare.

Tabs, Breadcrumb, Pagination, ProgressStepper

Tre pågående ärenden.

Inga avslutade ärenden.

Vem


2

Adress


3

Skola


4

Skicka

Exempel: flikar med role="tablist", brödsmulor som nav med aria-current="page", sidnumrering och stegindikator med bock på klara steg.

ProgressBar, Spinner, Avatar, List, Divider

Laddar
AL
KH
EN
  • Ansökan mottagen 14 september 2026
  • Handläggning pågår
  • Beslut skickas till din digitala brevlåda

Exempel: förloppsindikator i två lägen, spinner, avatarer med initialer i temafärg, lista och avdelare.

Accordion och Disclosure

  • Elever i förskoleklass, grundskola och anpassad grundskola.

  • Skolskjuts är kostnadsfri.

Villkorstext.

Exempel: dragspel med två frågor och en enskild utfällbar panel, renderade stängda. Öppning kräver komponentens klientkod.

Header, Footer, Logo, UserMenu, NavigationBar, MenuVertical

Exempel: sidhuvud med logotyp och tjänstenamn, navigeringsrad, vertikal meny med role="menubar", användarmeny och popup-meny (stängda), samt sidfot med länklista.

Det som inte går att visa statiskt

Modal, Snackbar och Toast, CookieConsent och Tooltip renderas av klientkod och kan inte visas utan React i webbläsaren. De 19 AI-komponenterna i @sk-web-gui/ai (AICornerModule, AIServiceModule, AIFeed, Bubble, ChatInput, Feedback, TypingBubble med flera) ingår inte i paraplypaketet och visas inte här; de dokumenteras på ui.sundsvall.dev/ai-komponenter/.

Tillämpning

Samma e-tjänst som i alternativ A, steg 2 av 4 i en ansökan om skolskjuts, byggd enbart av paketets komponenter: Header, Breadcrumb, ProgressStepper, FormControl, Input, RadioButton, Alert, Button och Footer. Rubrikerna är satta med sidans egen typografi eftersom paketet inte har någon rubrikkomponent; i en riktig tjänst är de vanliga h1 och h2 med paketets basstil.

Ansök om skolskjuts

För elever i förskoleklass, grundskola och anpassad grundskola. Du behöver e-legitimation. Det tar ungefär tio minuter.

Vem


2

Adress


3

Skola


4

Skicka

Steg 2 av 4: Adress

Adressen hämtas från folkbokföringen
Stämmer den inte behöver du först anmäla flytt till Skatteverket.
Exempel: e-tjänst byggd av dagens komponenter. Jämför med samma vy under Tillämpningar i alternativ A och med samtalsflödet i alternativ C.

Riktlinjer

Tillgänglighet, enligt portalen

  • Tangentbordsnavigering för all interaktion. Synligt fokus med minst 2 px ring.
  • Kontrast 4,5:1 för brödtext, 3:1 för stor text.
  • Synlig label på alla fält; placeholder ersätter aldrig en label. Fel kopplade med aria-describedby, ikon plus text.
  • button för åtgärder, a för navigering, aldrig div med onClick. Ikonknappar har aria-label med åtgärden.
  • Modaler flyttar fokus in, fångar det och återställer det. Tabeller har th scope. Bilder har alt.
  • Verifiering före publicering: axe eller Lighthouse utan fel, tabba igenom utan mus, skärmläsare, 200 % zoom.

Tonalitet, enligt portalen

  • Du-tilltal, aktiv form, korta meningar, vanliga ord. Förkortningar skrivs ut första gången.
  • Knapptext är verb i imperativ, 1 till 3 ord. Länktext beskriver målet.
  • En h1 per sida. H2 ur läsarens perspektiv: "När behöver jag bygglov?"
  • Felmeddelanden säger vad som är fel och vad du kan göra. "E-postadressen saknar ett snabel-a", inte "Ogiltig inmatning".
  • Datum 2026-05-27 eller 27 maj 2026. Klockslag 14:30. Telefon 060-19 10 00.
Portalens tillgänglighetssida hänvisar till en token --color-semantic-focus som inte finns; dess egen färgsida säger att fokusringen heter --color-light-ring. Det är ett exempel på varför A, B och C skriver regler som testbara påståenden i stället för prosa.

AI-native

Portalen ui.sundsvall.dev är byggd för att en AI-agent ska kunna producera kod som följer systemet utan mänsklig redigering i mellanled. Tre mekanismer:

  • llms.txt med innehållsöversikt enligt llmstxt.org, och llms-full.txt med hela portalen i en fil på 166 kB.
  • Markdown per sida: varje HTML-sida finns som .md på samma adress, med Content-Type: text/markdown och utan cache.
  • En sida "För AI-agenter" med tre grundregler: bygg aldrig om systemet lokalt, märk fristående HTML som icke-produktion, skriv svenska med du-tilltal och verb i imperativ. Plus en prompt-mall.

Komponentsidorna genereras ur Storybook: props-tabell med typer och standardvärden, enum-värden, standardargument och storyvarianter. Färgsidan har ett facit över vanliga AI-gissningar som inte finns, med det rätta namnet bredvid.

// Prompt-mall från ui.sundsvall.dev/for-ai/
Läs https://ui.sundsvall.dev/llms-full.txt och bygg [uppgift]
som följer Sundsvalls kommuns designsystem. Importera komponenter
från @sk-web-gui/react och tokens från @sk-web-gui/core.
Hårdkoda inga hex-värden eller CSS-variabler i mitt projekt.

// I koden
import { Button, FormControl, FormLabel, Input } from '@sk-web-gui/react';

<FormControl id="pnr" required>
  <FormLabel>Personnummer</FormLabel>
  <Input inputMode="numeric" />
</FormControl>
<Button color="vattjom">Skicka in ansökan</Button>
Skillnaden mot alternativen: referensen beskriver komponenternas API uttömmande men saknar mönster på vy-nivå (service-header, step-form, case-status), regler i form av testbara påståenden, ett felindex och kontrastregler för kanter och ytor. Det är just det A, B och C lägger till.

Tillgänglighet

Den här sidan är byggd efter tillgänglighetsanalysen: skip-länk, ett main, obruten rubrikordning, exempel som figurer med bildtext, tabeller med rubriker och rullbara behållare som nås med tangentbord, och inget skript som skriver över operativsystemets inställningar. Komponenternas egen tillgänglighet är paketets: roller, tillstånd och kopplingar kommer ur React-koden och är oförändrade här.

Kontrast, uppmätt ur paketets egna variabler

axe hittar sju kontrastfel på den här sidan i ljust läge och sju i mörkt, alla i paketets egna komponenter: statusknapparna info, success och warning, etiketten warning och det färgade kortet. De rättas inte här, eftersom sidan ska visa systemet som det är.

Paren nedan är beräknade ur de CSS-variabler paketet genererar, i ljust och mörkt läge. Halvtransparenta lager är sammansatta mot sidbotten. Brott markeras i rött: 6 i ljust läge och 4 i mörkt läge.

Tabell 3: kontrast i paketets tokens, ljust och mörkt läge
ParKravLjustMörkt
Brödtext på sidbotten4,516,3913,18
Dämpad text på sidbotten4,59,610,47
Länk (vattjom text-primary) på sidbotten4,58,8510,99
Primärknapp primary: vit text på primary-surface4,514,7413,15
Primärknapp vattjom: text-secondary på surface-primary4,56,46,54
Primärknapp gronsta: text-secondary på surface-primary4,55,045,22
Primärknapp bjornstigen: text-secondary på surface-primary4,59,167,76
Primärknapp juniskar: text-secondary på surface-primary4,55,895,76
Primärknapp info: text-secondary på surface-primary4,54,243,63
Primärknapp success: text-secondary på surface-primary4,53,853,57
Primärknapp warning: text-secondary på surface-primary4,53,483,85
Primärknapp error: text-secondary på surface-primary4,54,95,45
Accentyta vattjom: text-primary på surface-accent4,56,546,4
Accentyta gronsta: text-primary på surface-accent4,56,315,04
Accentyta bjornstigen: text-primary på surface-accent4,59,269,16
Accentyta juniskar: text-primary på surface-accent4,56,895,89
Accentyta info: text-primary på surface-accent4,56,546,4
Accentyta success: text-primary på surface-accent4,56,315,04
Accentyta warning: text-primary på surface-accent4,55,55,04
Accentyta error: text-primary på surface-accent4,55,456,29
Ljus botten vattjom: text-primary på background-2004,57,386,4
Ljus botten gronsta: text-primary på background-2004,56,317,19
Ljus botten bjornstigen: text-primary på background-2004,510,610,6
Ljus botten juniskar: text-primary på background-2004,57,717,71
Ljus botten info: text-primary på background-2004,57,387,38
Ljus botten success: text-primary på background-2004,57,197,19
Ljus botten warning: text-primary på background-2004,56,47,64
Ljus botten error: text-primary på background-2004,56,948,47
Fokusring på sidbotten33,513,76
Fältkant (input-field outline) på sidbotten33,264,54
Sekundärknappens kant på sidbotten31,912,58
Avdelare (divider) på sidbotten21,912,58
Yta background-200 mot sidbotten1,181,141,24

Vad dagens system har och saknar jämfört med analysens krav

Har

Mörkt läge som följer OS eller val. Fokusring på alla element via bas-CSS. Fält med label, hjälptext och fel kopplade med aria-describedby och aria-invalid. Radiogrupp, flikar, brödsmulor, combobox och menyer med rätt roller. Ikoner dolda för hjälpmedel. Tabell i rullbar behållare. Stegindikator med bock på klara steg.

Saknar

Högkontrastläge och stöd för prefers-contrast. Regler för kanter och intilliggande ytor; kanter är halvtransparenta lager på 30 till 50 procent. Callout bär status enbart med färg. Statusknapparna info, success och warning ligger på 3,5 till 4,2:1 mellan text och yta i ljust läge och 3,6 till 3,9:1 i mörkt; etiketten warning likaså. Det färgade kortet saknar textfärg (1,5:1). Sidfotens länkar är 22 px höga. Fokusringen #0C8CED ligger utanför profilen och nära 3:1 mot vitt. Ingen regelbok med testbara påståenden och inget felindex.

Alternativen mot referensen

Samma tabell som på startsidan, men med referensen först: så här förhåller sig varje alternativ till det som gäller i dag.

Tabell 4: alternativen A, B och C mot referensen
AspektReferens · dagens @sk-web-guiA · Sundsvall DSB · AuroraC · Startsidan
StatusI drift i kommunens tjänster, öppen källkod på npmFörslagFörslagI drift, en intern startsida
Omfång66 komponenter, 19 AI-komponenter13 komponenter, 8 mönsterSamma plus AI-tillstånd8 primitiver, 4 mönster, 3 ytor
FärgProfilens hex som steg 700 i sju skalor, fyra teman som propProfilens hex, verksamhetsfärg per tjänstHöjd kroma, gradienterEn identitetsfärg, Grönsta för AI
LägenLjust, mörkt, invertedLjust, mörkt, högkontrastLjust, mörkt, högkontrastLjust
TypografiRaleway + Arial, rem med semantiska storlekarRaleway + Inter, pxBricolage + Geist, remRaleway + Arial, rem
KomponentgrundEgna React-komponenter, Headless UI, Tailwind-presetshadcn/uishadcn/uishadcn/ui under egna primitiver
FormPillerformade knappar, 1,2rem radieRadie 4 till 20 px per nivåPiller och glasRadie 6 till 16 px
AI-reglerllms.txt, markdown per sida, sida för AI-agenter, props ur StorybookAGENTS.md med testbara påståendenFem UI-tillstånd för AIData med id, varianter, felindex
KontrastreglerInga; text 4,5:1 i riktlinjeKant 2:1, fält 3:1, ytor 1,18:1, i tokensSammaÖvertagna från A
PassarAllt som redan byggs i kommunen i dagMedborgartjänsterHandläggarverktygIntern arbetsyta

Vad jämförelsen visar

Referensen är komplett och används brett. A, B och C konkurrerar inte med dess komponenter; de föreslår det lager som saknas ovanför: högkontrast, kontrastregler för kanter och ytor, vy-mönster och regler som en agent kan kontrollera. Den avgörande frågan är om det laget ska läggas ovanpå dagens system eller byggas på shadcn/ui bredvid det. Varje alternativs egen sida länkar hit så att jämförelsen alltid görs mot samma utgångsläge.

Nästa steg

  1. Mät referensen i drift. Kör axe, kontrastparen och OS-lägena på ui.sundsvall.dev och på ett par tjänster som använder paketet, inte bara på den här stillbilden. Då blir jämförelsen rättvis.
  2. Pröva A:s regler på referensen. Lägg AGENTS.md-reglerna, kontrastreglerna och de åtta mönstren ovanpå @sk-web-gui i ett testprojekt, utan att byta komponenter. Det visar om det som saknas går att lägga till utan att byta system.
  3. Besluta om komponentgrund. shadcn/ui i A, B och C betyder att komponentkoden kopieras in och ägs av kommunen; @sk-web-gui betyder ett eget bibliotek som redan finns och underhålls. Båda är rimliga; blandning är det inte.
Sidan byggs om med npm run build i tools/referens-designsystem när paketen uppdateras. Versionerna i dag: react 3.1.3, core 4.6.2, theme 2.7.2.