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.
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.
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.
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".
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.
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.
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.
Typografin är semantisk, inte numerisk: display-1, h1 till h4, lead, base, large, small, label. Komponenterna väljer storlek per brytpunkt själva.
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.
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
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.
| Tema | surface primary | surface accent | text primary | text secondary | background 100 / 200 / 300 |
|---|---|---|---|---|---|
| Vattjom | blue 700 | blue 200 | blue 800 | blue 100 | blue 50 / 100 / 300 |
| Grönsta | green 700 | green 200 | green 800 | green 100 | green 50 / 200 / 300 |
| Björnstigen | purple 700 | purple 200 | purple 800 | purple 100 | purple 50 / 100 / 300 |
| Juniskär | pink 700 | pink 200 | pink 800 | pink 100 | pink 50 / 100 / 300 |
| Success | green 600 | green 200 | green 800 | green 100 | green 50 / 100 / 300 |
| Warning | orange 600 | orange 200 | orange 800 | vit | orange 50 / 100 / 300 |
| Error | red 600 | red 300 | red 800 | vit | red 50 / 100 / 300 |
| Info | blue 600 | blue 200 | blue 800 | blue 100 | blue 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
| Token | Värde | Används till |
|---|---|---|
| display-1 | 8rem (80 px) | Hero och landningssida |
| h1 | 4rem (40 px) | Sidans huvudrubrik |
| h2 | 3.2rem (32 px) | Sektionsrubrik |
| h3 | 2.6rem (26 px) | Underrubrik |
| h4 | 2.4rem (24 px) | Mindre rubrik |
| lead | 2rem (20 px) | Ingress |
| base / large / small | 1.6 / 1.8 / 1.4rem | Brödtext, större brödtext, metadata |
| label sm–lg | 1.2–1.8rem | Formulä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.
Komponenter
Ett urval av de 66 komponenterna, renderade av paketet. Knappar och fält i exemplen är riktiga element men utför ingenting.
Button
Link
Läs mer på sidan om skolskjuts eller sundsvall.se.
Alert
Badge, Label, Chip, Callout
Card och MetaCard
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
Högst 500 tecken. Skriv inte personnummer här.
aria-invalid och kopplas med aria-describedby; ikonen är dold för hjälpmedel och texten bär felet.role="radiogroup", Switch, SearchField, Combobox med role="combobox" och FileUpload.Table
| Ärende | Gäller | Status | Uppdaterad |
|---|---|---|---|
| SBK-2026-0412 | Skolskjuts, Elias | Beviljat | 15 sep 2026 |
| BYG-2026-1188 | Bygglov, garage | Handläggs | 11 sep 2026 |
| MIL-2026-0071 | Eldstad | Komplettering behövs | 9 sep 2026 |
Tabs, Breadcrumb, Pagination, ProgressStepper
Tre pågående ärenden.
Inga avslutade ärenden.
Vem
Adress
Skola
Skicka
role="tablist", brödsmulor som nav med aria-current="page", sidnumrering och stegindikator med bock på klara steg.ProgressBar, Spinner, Avatar, List, Divider
- Ansökan mottagen 14 september 2026
- Handläggning pågår
- Beslut skickas till din digitala brevlåda
Accordion och Disclosure
Elever i förskoleklass, grundskola och anpassad grundskola.
Skolskjuts är kostnadsfri.
Villkorstext.
Header, Footer, Logo, UserMenu, NavigationBar, MenuVertical
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
Adress
Skola
Skicka
Steg 2 av 4: Adress
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
labelpå alla fält; placeholder ersätter aldrig en label. Fel kopplade medaria-describedby, ikon plus text. buttonför åtgärder,aför navigering, aldrigdivmed onClick. Ikonknappar hararia-labelmed å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.
--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
.mdpå samma adress, medContent-Type: text/markdownoch 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>
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.
| Par | Krav | Ljust | Mörkt |
|---|---|---|---|
| Brödtext på sidbotten | 4,5 | 16,39 | 13,18 |
| Dämpad text på sidbotten | 4,5 | 9,6 | 10,47 |
| Länk (vattjom text-primary) på sidbotten | 4,5 | 8,85 | 10,99 |
| Primärknapp primary: vit text på primary-surface | 4,5 | 14,74 | 13,15 |
| Primärknapp vattjom: text-secondary på surface-primary | 4,5 | 6,4 | 6,54 |
| Primärknapp gronsta: text-secondary på surface-primary | 4,5 | 5,04 | 5,22 |
| Primärknapp bjornstigen: text-secondary på surface-primary | 4,5 | 9,16 | 7,76 |
| Primärknapp juniskar: text-secondary på surface-primary | 4,5 | 5,89 | 5,76 |
| Primärknapp info: text-secondary på surface-primary | 4,5 | 4,24 | 3,63 |
| Primärknapp success: text-secondary på surface-primary | 4,5 | 3,85 | 3,57 |
| Primärknapp warning: text-secondary på surface-primary | 4,5 | 3,48 | 3,85 |
| Primärknapp error: text-secondary på surface-primary | 4,5 | 4,9 | 5,45 |
| Accentyta vattjom: text-primary på surface-accent | 4,5 | 6,54 | 6,4 |
| Accentyta gronsta: text-primary på surface-accent | 4,5 | 6,31 | 5,04 |
| Accentyta bjornstigen: text-primary på surface-accent | 4,5 | 9,26 | 9,16 |
| Accentyta juniskar: text-primary på surface-accent | 4,5 | 6,89 | 5,89 |
| Accentyta info: text-primary på surface-accent | 4,5 | 6,54 | 6,4 |
| Accentyta success: text-primary på surface-accent | 4,5 | 6,31 | 5,04 |
| Accentyta warning: text-primary på surface-accent | 4,5 | 5,5 | 5,04 |
| Accentyta error: text-primary på surface-accent | 4,5 | 5,45 | 6,29 |
| Ljus botten vattjom: text-primary på background-200 | 4,5 | 7,38 | 6,4 |
| Ljus botten gronsta: text-primary på background-200 | 4,5 | 6,31 | 7,19 |
| Ljus botten bjornstigen: text-primary på background-200 | 4,5 | 10,6 | 10,6 |
| Ljus botten juniskar: text-primary på background-200 | 4,5 | 7,71 | 7,71 |
| Ljus botten info: text-primary på background-200 | 4,5 | 7,38 | 7,38 |
| Ljus botten success: text-primary på background-200 | 4,5 | 7,19 | 7,19 |
| Ljus botten warning: text-primary på background-200 | 4,5 | 6,4 | 7,64 |
| Ljus botten error: text-primary på background-200 | 4,5 | 6,94 | 8,47 |
| Fokusring på sidbotten | 3 | 3,51 | 3,76 |
| Fältkant (input-field outline) på sidbotten | 3 | 3,26 | 4,54 |
| Sekundärknappens kant på sidbotten | 3 | 1,91 | 2,58 |
| Avdelare (divider) på sidbotten | 2 | 1,91 | 2,58 |
| Yta background-200 mot sidbotten | 1,18 | 1,14 | 1,24 |
Vad dagens system har och saknar jämfört med analysens krav
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.
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.
| Aspekt | Referens · dagens @sk-web-gui | A · Sundsvall DS | B · Aurora | C · Startsidan |
|---|---|---|---|---|
| Status | I drift i kommunens tjänster, öppen källkod på npm | Förslag | Förslag | I drift, en intern startsida |
| Omfång | 66 komponenter, 19 AI-komponenter | 13 komponenter, 8 mönster | Samma plus AI-tillstånd | 8 primitiver, 4 mönster, 3 ytor |
| Färg | Profilens hex som steg 700 i sju skalor, fyra teman som prop | Profilens hex, verksamhetsfärg per tjänst | Höjd kroma, gradienter | En identitetsfärg, Grönsta för AI |
| Lägen | Ljust, mörkt, inverted | Ljust, mörkt, högkontrast | Ljust, mörkt, högkontrast | Ljust |
| Typografi | Raleway + Arial, rem med semantiska storlekar | Raleway + Inter, px | Bricolage + Geist, rem | Raleway + Arial, rem |
| Komponentgrund | Egna React-komponenter, Headless UI, Tailwind-preset | shadcn/ui | shadcn/ui | shadcn/ui under egna primitiver |
| Form | Pillerformade knappar, 1,2rem radie | Radie 4 till 20 px per nivå | Piller och glas | Radie 6 till 16 px |
| AI-regler | llms.txt, markdown per sida, sida för AI-agenter, props ur Storybook | AGENTS.md med testbara påståenden | Fem UI-tillstånd för AI | Data med id, varianter, felindex |
| Kontrastregler | Inga; text 4,5:1 i riktlinje | Kant 2:1, fält 3:1, ytor 1,18:1, i tokens | Samma | Övertagna från A |
| Passar | Allt som redan byggs i kommunen i dag | Medborgartjänster | Handläggarverktyg | Intern 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
- 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.
- 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.
- 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.
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.