Sundsvall DS · Alternativ CStartsidan – hämtat ur ekosystemet i drift
Lägger på ett filter som liknar en TV eller projektor som tappar ljusa toner.
Alternativ C

Designsystemet som redan är i drift.

Alternativ A och B är förslag. Alternativ C är hämtat ordagrant ur Startsidan, ekosystemet för medarbetare och chef på start.sundsvall.dev: tokens ur packages/tokens, primitiver ur packages/ui, ytor ur skalet och regler ur /dev/ui. Ingenting på den här sidan är påhittat för testytan.

Ett skal, många moduler

Användaren ser en sida. Bakom den är varje funktion ett fristående paket med ett manifest som säger vilka platser det fyller: nyckeltal, huvudspalt, sidospalt, "Att agera på", AI-förslag. Nästa tjänst byggs in i samma yta i stället för att bli ett nytt gränssnitt.

Systemet är data

Tokens, primitiver, mönster och regler är typade poster med stabila id, uttömmande varianter, villkoren "använd när / använd inte" och ett felindex. Samma data renderas som sida, som JSON och som text för modeller.

Färg betyder något

Blått är identitet, avvikande färg är status, och Grönsta är reserverat för AI. Allt maskinskrivet bär märket AI-genererat. AI föreslår, människan beslutar.

Var det kommer ifrån

Tabell 1: källor i repot startsidan
DelKälla i repot startsidanPå den här sidan
Tokenspackages/tokens/src/theme.css, Tailwind v4 @theme med shadcn-kontraktFärg, typografi och form; kopierad som globals.startsidan.css och härledd till tokens.startsidan.json
Primitiverpackages/ui/src: Card, Chip, AiChip, Btn, StatusRow, ListRow, Progress, Avatar, MoreLink, Table ovanpå shadcn/uiPrimitiver
Mönster och ytorapps/web/src/app/dev/ui/system/poster.ts och skalets shell.cssMönster, Ytor
Reglerregler.ts: R1–R10, felindex, checklista; lintregeln inga-hardkodade-designvardenRegler och felindex
Designfacitdocs/startsidan-prototyp-v3.html, felanmalan-poc.html, utvecklingsarende-prototyp.html, it-support-prototyp.htmlYtor
BeslutADR-008 shadcn som komponentgrund, ADR-009 designsystem som data, ADR-010 devportalAI-native

Principer

Systemet har tio bärande regler i prioritetsordning. De fem som formar utseendet:

Grönt är AI, aldrig statusAnvändaren ska kunna se på färgen, och alltid på märket, att något är maskinskrivet. Statusgrönt (#12874e) och AI-grönt Grönsta (#00733b) är två toner med två betydelser.
Blått är identitetDen här personen, den här saken. En avatar är alltid blå, för en person har ingen status. Identitet och status delar aldrig färgskala.
Status bärs av kant, chip eller värde, plus textAldrig av en hel yta, och aldrig av färg ensam. Fylls hela kortet i rött tar en enskild avvikelse över arbetsytans intryck.
Allt AI-genererat är märktMärket AI-genererat är ett löfte, inte en dekoration. Ett grönt kort utan märke är ett fel, och ett märke på API-data är en osanning.
Färg ur tokens, mått i remInga hex-värden i kod och inga px i hakparentes. Rotens font-size är 62,5 % så att 1rem = 10px; rem följer med när användaren ändrar textstorlek, px gör det inte. En lintregel stoppar båda.
Varje kort har en tillgänglig rubrikKortet renderas som section med aria-labelledby. Radix under shadcn bär fokus, roller och tangentbord i menyer, avatar och förloppsindikator.

Färg

Fyra grupper. Gruppens regel avgör om en token får användas alls; betydelsen avgör var. Kontrasten är beräknad mot den yta som token faktiskt används på.

Neutraler

Tabell 2: neutrala tokens
TokenVärdeBetydelseKontrast
ink#1f1f25Brödtext och rubriker16,4:1 mot kort, 14,4:1 mot sida
ink-soft#4a4a55Metatext, andrahandsinformation8,7:1 mot kort, 7,7:1 mot sida
ink-faint#5f6b75 justeradPlatshållartext i fält som väntar på innehåll. Källan har #9aa3ad (2,6:1).5,5:1 mot kort, 4,8:1 mot sida
surface#fffKortets botten1,14:1 mot sida. Kortet bärs av skugga och ram
page#edf1f5Sidans botten, rader inuti kort
page-deep#e4eaf0Ett steg mörkare botten för helbreddsband1,07:1 mot sida, 1,21:1 mot kort
border#a5b1bc justeradKortets ram, tunna avdelare. Källan har #dde3e9 (1,29:1).2,2:1 mot kort, 1,9:1 mot sida
border-strong#76828d justeradRam på interaktiva ytor: fält, ghost-knapp. Källan har #c3ccd4 (1,6:1).3,9:1 mot kort, 3,5:1 mot sida
muted-bg#eef0f2Dämpad chipbotten, listavdelare
muted-tx#5a6470Text på dämpad botten5,3:1 mot muted-bg

Identitet: blå

Blått betyder "den här personen eller saken". Primärknapp, avatar, aktiv markering, länk. Aldrig status.

Tabell 3: identitetstokens
TokenVärdeBetydelseKontrast
blue#005595Primärknapp, avatar, aktiv markering. Profilens Vattjom.7,7:1 med vit text
blue-h#004070Hover på primärknapp. Mörknar, blir inte genomskinlig.10,7:1 med vit text
blue-bg#eaf1f8Ljus botten: hover på rader, info-chip
blue-acc#cfe0ecAccentram, kort vid hover1,35:1 mot kort
blue-tx#004c85Länktext, text på blue-bg8,9:1 mot kort, 7,8:1 mot blue-bg
blue-lift#1472b8Identitetsblå mot mörk platta: avatar i sidopanel och fokuslägets topprad5,1:1 med vit text, 2,2:1 mot sidopanelen
sidebar#003c69Endast sidopanelens botten11,4:1 med vit text, 7,5:1 med navlänkens 78 % vit

Status

Grönt är klart, gult väntar, rött är tidsgräns eller avvikelse. Bärs av en kantlinje, ett chip eller ett enskilt värde.

Tabell 4: statustokens
TokenVärdeBetydelseKontrast
green#12874eKlart. Statusgrönt, inte AI-grönt.4,0:1 som kant mot sida
green-bg / green-tx#e8f4ec / #0c6a3cChip tone="ok", nyckeltalsvärde som är bra5,9:1 i chip, 6,7:1 mot kort
amber#b06a1fVäntar på någon annan. Endast som kant och punkt, aldrig som text.3,75:1 som kant mot sida. Som text används amber-tx (6,4:1).
amber-bg / amber-tx#fbeede / #8a5117Chip tone="warn"5,6:1 i chip
red#b3261eTidsgräns passerad, avvikelse. Kant, chiptext, destruktiv knapp.5,8:1 som kant mot sida, 6,5:1 med vit text
red-bg#fcecebChip tone="avv", text i red5,7:1 i chip

AI: Grönsta, reserverat

Får bara bära ytor där AI gör något: AI-fältet, AI-knappen, AI-märket, AI-tonade kort. Aldrig status.

Tabell 5: AI-tokens
TokenVärdeBetydelseKontrast
ai#00733bAI-knapp, AI-märke, AI-fältets fokusram. Profilens Grönsta.6,0:1 med vit text
ai-deep / ai-tx#00592dHover på AI-knapp; text på ai-bg8,5:1 med vit, 8,0:1 mot ai-bg
ai-bg#f1f9f5Botten på AI-tonade kort och chips1,07:1 mot kort
ai-acc#c9e4d7Tonad ram på AI-ytor utan interaktion1,35:1 mot kort; därför ny token nedan för kanter som ska synas
ai-line#2f8f5e nyKant på AI-fältet, AI-chips, AI-bubblor och AI-kort. Finns inte i källan.4,0:1 mot kort, 3,6:1 mot sida
Profilens övriga färger (Björnstigen, Juniskär) används inte i C. Systemet har en identitetsfärg, inte en per verksamhet. Det är ett medvetet val för en intern startsida och ett gap för e-tjänster; se Jämförelse.

Typografi och form

Typsnitt och skala

Rubriker, knappar, chips och radrubriker i Raleway. Brödtext och all UI-text i Arial. Rotens font-size är 62,5 %, så 1rem = 10px och Tailwinds skala får sin vanliga px-semantik.

Tabell 6: typografisk skala
NamnVärdeAnvänds till
text-eyebrow1.2rem (12px) justeradVersal etikett över nyckeltal. Källan har 1.1rem (11 px), under systemets egen minimigräns.
text-xs1.2rem (12px)Metatext, chips, sidfot
text-sm1.4rem (14px)Radrubriker, knappar
text-base1.6rem (16px)Brödtext
text-h21.7rem (17px)Kortrubrik, sätts av Card
text-lg1.8rem (18px)AI-fältets inmatning, ingress
text-kpi3rem (30px)Nyckeltalets värde

Rum, radie, skugga

Avstånd i steg om 0,4rem. Fyra radier med tydlig hierarki: chip 6 px, knapp 8 px, shadcns radie 10 px, kort 16 px. Två skuggor: shadow-card för allt på arbetsytan, shadow-pop för menyer som svävar.

Exempel: radierna 6, 8, 10 och 16 px, samt kort med shadow-card och shadow-pop.

Innehållsbredden är 128rem (1280 px). Sidopanelen är 26rem, ihopfälld 7,2rem. Sidospalten på arbetsytan är 36rem.

Primitiver

Åtta exporterade primitiver ur @startsidan/ui, byggda ovanpå shadcn/ui (new-york, Tailwind v4) men med prototypens mått. Moduler använder dem och skriver aldrig egna färger. Varje post har "använd när" och "använd inte".

Card

Vitt kort med mjuk skugga, grundformen för allt innehåll. Renderas som section med aria-labelledby; rubriken sätts av kortet. Använd när en modul lägger något i huvud- eller sidospalten. Använd inte för nyckeltal, och aldrig kort i kort.

<Card headingId="arenden-h" title="Mina ärenden" count={4}
      action={<MoreLink href="/flode/arenden">Visa alla →</MoreLink>}>
  <ul className="grid list-none">…</ul>
</Card>
Mina ärenden4Visa alla
  • Behörighet HeromaInkom 12 mars · IT-supportVäntar
  • Ny datorBeställd 3 marsKlart
  • PasserkortTidsgräns 20 marsFörsenad
Exempel: Card med count, MoreLink och tre ListRow-rader med Chip.

Chip och AiChip

Litet statusmärke med punkt före texten, fyrkantigare än shadcns pillerbadge. Fem toner som följer av data, inte av smak: ok, warn, info, muted, avv. AiChip är märkningen av AI-genererat innehåll och får aldrig utelämnas på AI-ytor. Stjärnan byts inte ut; den renderas dold för hjälpmedel (aria-hidden) och texten "AI-genererat" bär betydelsen.

<Chip tone="ok">Klart</Chip>
<Chip tone="warn">Väntar på chef</Chip>
<AiChip />
<AiChip> Föreslagen prioritet</AiChip>
KlartVäntar på chefPlaneratUtkastFörsenad AI-genererat Sammanfattad av AI
Exempel: de fem chiptonerna och två AiChip. Texten bär betydelsen; punkten och färgen förstärker.

Btn och BtnLink

Knappen i prototypens mått, mätt i padding i stället för fast höjd. Tre varianter: primary är blå och huvudhandlingen, ghost är vit med bård för sidohandlingar, ai är Grönsta och bara för handlingar som utför något AI-genererat. Ett kort har högst en primary.

<Btn>Godkänn</Btn>
<Btn variant="ghost" size="sm">Visa detaljer</Btn>
<Btn variant="ai"> Sammanfatta åt mig</Btn>
<BtnLink href="/flode/felanmalan">Felanmäl</BtnLink>
Exempel: primary, ghost och ai i storlek md och sm. Fokusringen är 2 px i blue med 2 px avstånd.

StatusRow

Rad med färgad vänsterkant: titel, meta och handlingar till höger. Kanten bär statusen visuellt och raden renderar alltid statusen som text, synligt i ett chip eller dolt för hjälpmedel ("Status: tidsgräns"). Resten av raden förblir lugn. krit röd för passerad tidsgräns, warn gul, info blå, ok grön, neutral grå. Handlingar i ordningen AiChip, Chip, knapp. Renderas som li i en ul.

<StatusRow status="krit"
  title="Attestera tidrapport"
  meta="Tidsgräns passerad · 2 dagar"
  end={<BtnLink href="#" size="sm">Attestera</BtnLink>} />
Att agera på4Visa alla
  • Status: tidsgräns. Rehabärende – tidsgräns om 5 dagarPlan ska vara upprättad senast 24 aug · underlag sammanställt Utkast klartÖppna
  • Status: redo. Attest: 4 ledighetsansökningarBemanningen täcker samtliga perioderRedoGodkänn
  • Status: information. Rekrytering IT-konsult: beslut om slutkandidatReferenser inhämtade · jämförelsematris finns Matris klarGranska
  • Status: väntar. 2 utvecklingssamtal saknar bokad tidSka vara genomförda före 30 sepPågårBoka
Exempel: kortet "Att agera på" med fyra StatusRow i status krit, ok, info och warn. Länkarna leder till avsnittet Mönster.

ListRow, Progress och Avatar

ListRow är raden i en innehållslista: tunn avdelare, ingen ram, valfri Avatar framför och Chip eller värde till höger. Progress under raden är Radix under ytan och får role="progressbar" med rätt aria-värden; grön när klar, annars blå. Avatar är identitetsikon med initialer, alltid blå, ingen färgvariant finns och ska inte tillkomma.

<ListRow lead={<Avatar initials="AL" />}
  title="Utvecklingsplan 2026" meta="Uppdaterad 12 mars"
  end={<Chip tone="warn">Väntar</Chip>}>
  <Progress value={60} />
</ListRow>
UtvecklingAlla
  • Utvecklingsplan 2026Uppdaterad 12 marsVäntar
  • Ledarskapsprogram, steg 2Klart 8 septemberKlart
Exempel: två ListRow med Avatar, Progress (60 % blå, 100 % grön) och Chip.

Table

shadcns tabell, vidarelänkad för moduler med fler än två jämförbara fält per rad. Tabellen bär egen luft: kortet får bodyClassName="px-0 pb-0" så att raderna går kant i kant, och kolumnspåret måste kunna krympa, annars trycker tabellen ut sidan.

Mönster

Nyckeltalsruta

Ett mätvärde med versal etikett, stort tal och en kommentar. Hela rutan är en länk. Värdet bär tonen, aldrig hela rutan, och tonen har alltid en textmotsvarighet: kommentaren säger vad talet betyder, eller en dold text ("Gynnsamt", "Kräver åtgärd") läggs före värdet. Etiketten avstavas hellre än kapas. Används i sloten kpi, som spänner över hela arbetsytans bredd i fyra spår.

AI-yta

Ett kort där innehållet är maskinskrivet: Grönsta-tonad botten, ram och märke. tone="ai" och AiChip hör ihop; den ena utan den andra är ett fel. En AI-yta ska kunna peka på sin källa.

Att agera på

Kortet som aggregerar andra modulers handlingar till en lista. En modul bidrar med rader via slots.actions i sitt manifest och renderar aldrig ett eget sådant kort. Statusen på raden följer av data: passerad tidsgräns ger krit, väntar på någon ger warn.

Modulkort

Den vanligaste formen: en server component som hämtar sin data och renderar ett Card. Ingen "use client". Rolltexten väljs i komponenten. Nyckel sätts på datats id.

Exempel: två nyckeltalsrutor. Värdet bär tonen: blått neutralt, grönt bra.
Din vecka AI-genererat

Tre ärenden väntar på dig, varav ett har passerat sin tidsgräns. Rehabärendet har ett utkast klart att granska.

Exempel: AI-yta med tone="ai", AiChip, en AI-knapp och en källknapp.
// packages/modules/<namn>/src/manifest.ts
slots: {
  actions: [{
    id: "ledighet-attest", roles: ["chef"],
    items: async (ctx) => [{
      id: "att-1", status: "warn",
      title: "Attestera ledighet – Kim H", meta: "Inkom 12 mars",
      chip: { tone: "warn", label: "Väntar" },
      action: { href: "/flode/ledighet", label: "Attestera" },
    }],
  }],
}

Ytor

Tre ytformer i ett skal. Skalet äger layout, sidopanel, AI-fält, identitet och roll; det vet vilka platser som finns men aldrig vad som står i dem.

Verktygsytan

Rollfiltrerad och datadriven, komponerad av modulernas slots: en helbreddsrad för nyckeltal, en huvudspalt och en sidospalt på 36rem. Under 1180 px blir rutnäten enspaltiga. Överst ligger AI-fältet: hälsning, fråga och rollens förslag. Fältet är runt och Grönsta-kantat; formen betyder AI.

Exempel: verktygsytan för rollen chef. Marinblå sidopanel med Verktyg och Sidor, AI-fältet med tre förslag, fyra nyckeltal, "Att agera på" i huvudspalten och "Idag" i sidospalten. Bilden är en stillbild utan interaktion.

Fokusflöde

Helskärm utan sidopanel: en smal topprad med Avbryt och ett ärende från början till slut. Två former finns i drift. Samtalsflödet felanmälan: chatt till vänster, formulärspegel till höger, grön kant på varje fält assistenten fyllt i; ärendet skapas först när användaren bekräftat och servern själv kontrollerat att allt obligatoriskt finns. Dokumentflödet utvecklingsärende: fyra steg med typade avsnitt där assistenten skriver ett första utkast ur uppladdat underlag, rubrik för rubrik, som användaren arbetar igenom.

Krav för hjälpmedel i båda flödena: samtalet är en role="log"-lista med talaretikett per meddelande ("Du:", "Assistenten:"), "assistenten skriver" och "svaret är klart" annonseras i en separat statusregion, ett fält som assistenten fyllt i får aria-describedby som säger att värdet är föreslaget och väntar på godkännande, och ett förslag godkänns med en knapp, aldrig genom att fokus flyttas.

Exempel: samtalsflödet felanmälan. Vänster: assistentens fråga i Grönsta-tonad bubbla och en systemnotis. Höger: formulärspegeln med hämtade uppgifter, ett fält som väntar och ett fält assistenten fyllt i, markerat med grön kant.

Sida

Redaktionellt innehåll under Sidor i sidopanelen, i två varianter: ingång med brödsmulor, ingress, AI-fält och ett rutnät av kortlänkar där det första kortet är fyllt i sidopanelens blå, och artikel med rubrik, ingress och löptext. Samma skal, samma tokens.

Regler och felindex

Tio regler i prioritetsordning: bryter två mot varandra vinner den som står först. Var och en har ett skäl, inte bara ett påbud.

Tabell 7: de tio reglerna
RegelLyderDärför
R1Grönt (ai-*) är reserverat för AI-ytor och får aldrig betyda status.Användaren ska se på färgen ensam att något är maskinskrivet.
R2Allt AI-genererat märks synligt med AiChip.Märkningen är ett löfte till användaren, inte en dekoration.
R3Blått betyder identitet. Avvikande färg betyder status.En avatar i rött skulle läsas som att personen är försenad.
R4Färg ur tokens, inga hex i className. Mått ur Tailwinds skala eller i rem, aldrig px.Hex överlever inte nästa temaändring; px bryter skalningen när användaren ändrar textstorlek. Lint fäller båda.
R5Statusfärg bärs av kantlinje, chip eller enskilt värde, aldrig av en hel yta, och alltid tillsammans med text.Fylls hela kortet i rött tar en avvikelse över hela arbetsytan.
R6Moduler skriver Tailwind-utilities. shell.css ägs av skalet.Skalets krom är porterad 1:1 från prototypen.
R7Server components som default.Modulerna hämtar sin data på servern.
R8Varje kort får en tillgänglig rubrik via headingId.Utan den är kortet en namnlös region för skärmläsaren.
R9Svenska i all UI-text, i visade props-värden och i commit-ämnen.Blandat språk läcker igenom i demolägen.
R10TypeScript strict, inga any. Varianter som unionstyper.Unionen gör varianterna uppräkningsbara för kompilator och specifikation.

Felindex: fel, rätt, varför

De misstag som faktiskt uppstår när någon bygger snabbt. Formen går att kontrollera mot en diff.

Tabell 8: felindex
FelRättVarför
bg-ai-bg på ett kort som visar "Klart"<Chip tone="ok">Klart</Chip> på ett vanligt kortAI-grönt och statusgrönt har olika betydelse (R1).
text-[#005595]text-blueHårdkodad färg går förbi tokens (R4). Fångas av lint.
text-[14px]text-sm, eller rem när skalan inte räckerpx bryter skalningen vid ändrad textstorlek (R4).
shadcns Button direkt<Btn> ur @startsidan/uiBtn bär prototypens mått och varianten ai.
<Card> utan headingId<Card headingId="arenden-h" title="Mina ärenden">Kortet är en section och behöver aria-labelledby (R8).
AI-sammanfattning som vanlig textSamma text med AiChip intill, eller i ett kort med tone="ai"Omärkt AI-innehåll bryter löftet (R2).
Avatar i grön eller röd variant<Avatar initials="AL" />, status bredvidIdentitet och status delar inte färgskala (R3).
Egen div med role="progressbar"<Progress value={60} />Radix sätter aria-valuenow, min och max korrekt.

Lint

Regeln startsidan/inga-hardkodade-designvarden läser varje className, även inuti cn() och mallsträngar, och fäller hex-färger och px-mått i hakparentes. Räckvidden är medvetet begränsad: shadcn-grunden och dokumentationens egna exempel undantas utan undantagslistor, och luckan "klasslistor i konstanter" står i felindexet i stället för att låtsas vara täckt.

AI-native

Systemet är skrivet som typad data i apps/web/src/app/dev/ui/system/ och renderas i tre former ur samma källa. Ingen av dem får innehålla en regel som saknas i de andra.

Tabell 9: tre renderingar av systemet
YtaFormFör vem
/dev/uiSida med levande exempel, renderade med samma primitiver som modulernaMänniskan
/dev/ui/spec.jsonJSON, otidsstämplad så att två anrop går att diffaVerktyg
/dev/ui/llms.txtPlattext på 25 kB, hela systemet i ett sammanhangsfönsterModellen

Fyra egenskaper gör det läsbart för en modell: stabila id som ui.card och monster.aiyta som aldrig ändras; uttömmande varianter, så att en modell som ser ["ok","warn","info","muted","avv"] inte hittar på en sjätte; villkor i stället för smak; och fel bredvid rätt.

Skillnaden mot A och B. A och B beskriver hur en agent ska bygga en tjänst med ett registry. C har redan ett kontrakt för hur en agent bygger en modul: ett manifest med roller, slots, routes och AI-förslag, och en devportal där varje funktion måste ha en katalogpost och ett dok innan den räknas som klar. Portalens påståenden om koden verifieras i test, så att dokumentationen inte kan glida ifrån det som finns.
// packages/module-sdk/src/types.ts (förkortat)
interface ModuleManifest {
  id: string;
  name: string;
  roles: Role[];                 // "medarbetare" | "chef"
  nav?: NavEntry[];              // punkter under Verktyg
  routes?: ModuleRoute[];        // helskärmsflöden, mode: "focus"
  slots?: {
    kpi?: Widget[];
    main?: Widget[];
    side?: Widget[];
    actions?: ActionsProvider;   // rader i Att agera på
  };
  ai?: {
    suggestions?: (ctx: UserContext) => Suggestion[];
    intents?: IntentHandler[];
  };
}

Tillgänglighet

Den här sidan är byggd efter tillgänglighetsanalysen av A och B: skip-länk, ett main, obruten rubrikordning, exempel som figurer med bildtext, mockar dolda för hjälpmedel, inga textstorlekar under 12 px, förloppsindikatorer med riktiga aria-värden, tabeller med kolumnrubriker och rullbara behållare som nås med tangentbord, och inget skript som skriver över operativsystemets inställningar.

Vad systemet gör rätt

  • Radix under shadcn bär fokus, roller och tangentbord i avatar, förloppsindikator och menyer. Progress får role="progressbar" med värden.
  • Varje kort är en namngiven section via headingId. Sidopanelens aktiva länk bär aria-current="page". Rollväljaren använder aria-checked.
  • Status bärs alltid av text i chip eller rad, aldrig av färg ensam. Kant, chip och värde förstärker.
  • Rem-skala med rot på 62,5 %: textzoom i webbläsaren och OS-textstorlek på mobil fungerar. Lint förbjuder px.
  • Global fokusring 2 px i blått med 2 px avstånd. prefers-reduced-motion stänger av alla animationer och övergångar.
  • Alla textpar klarar 4,5:1 med god marginal: brödtext 16:1, metatext 8,7:1, länk 8,9:1, chips 5,3 till 7,9:1, knappar 6 till 10,7:1.

Justeringar mot källan

Analysen av A och B mätte samma saker på C:s tokens och hittade sex gap. De är åtgärdade här, i tokens.startsidan.json och som ett tilläggsblock sist i globals.startsidan.css, så att värdena kan föras tillbaka till källrepot som en ändring i packages/tokens/src/theme.css. Alla justerade värden är markerade i tabellerna ovan.

Tabell 10: justerade värden i alternativ C
GapKällanJusteratKrav
Fältkant och ghost-knappens ramborder-strong #c3ccd4, 1,6:1#76828d, 3,9:1 mot kort och 3,5:1 mot sidaWCAG 1.4.11, 3:1
Kortramborder #dde3e9, 1,29:1#a5b1bc, 2,2:1 mot kortSystemregel A: kant ≥ 2:1 så att kortet syns när skuggan försvinner
AI-fältets och AI-ytornas kantai-acc #c9e4d7, 1,35:1Ny token ai-line #2f8f5e, 4,0:1; ai-acc behålls för tonade ramar utan interaktionWCAG 1.4.11, 3:1
Platshållartextink-faint #9aa3ad, 2,6:1#5f6b75, 5,5:1WCAG 1.4.3, 4,5:1
amber som textamber #b06a1f, 4,3:1 som nyckeltalsvärdeamber-tx #8a5117, 6,4:1; amber används bara som kant och punktWCAG 1.4.3, 4,5:1
Små versaler11 px etiketter, sidopanelens gruppetiketter i 50 % vit (4,0:1), notisbricka 3,7:112 px; etiketter i 70 % vit (6,3:1); bricka i red (6,5:1)Systemregel A: aldrig under 12 px; WCAG 1.4.3

Kvarstående gap som inte går att lösa i tokens: källan har bara ljust läge och inga verksamhetsfärger. Det är inte ett WCAG-krav, men A och B har båda, och EN 301 549 v4 kräver att användarens inställningar respekteras. Vägen dit beskrivs under Nästa steg.

Jämförelse med A och B

Referenspunkt: alla alternativ mäts mot dagens designsystem, @sk-web-gui, renderat ur de riktiga paketen. Där finns tabellen med referensen först; här jämförs C bara med A och B.

Tabell 11: jämförelse mellan alternativ A, B och C
AspektA · Sundsvall DSB · AuroraC · Startsidan
StatusFörslagFörslagI drift på start.sundsvall.dev, åtta moduler, två AI-flöden
FärgProfilens hex exakt, en verksamhetsfärg per tjänst, fyra valProfilens nyanser med höjd kroma, gradienterProfilens hex exakt, en identitetsfärg (Vattjom), Grönsta reserverad för AI
LägenLjust, mörkt, högkontrast, TV-testLjust, bläckmörkt, högkontrast, TV-testLjust
TypografiRaleway + Inter, px-skalaBricolage Grotesque + GeistRaleway + Arial, rem-skala med 62,5 % rot
Komponentgrundshadcn/ui, registryshadcn/ui, registry, JSON-schema för generativt UIshadcn/ui inkopierat, åtta primitiver med eget API, ingen registry
AI-reglerAGENTS.md med testbara påståendenFem UI-tillstånd för AI-innehållData med id, varianter, villkor och felindex; llms.txt och spec.json; modulmanifest
LintPlanerad: no-hex, no-palette, soft-surface-needs-borderPlaneradFinns: inga hex, inga px i className
Kontrast på kanterRegel 2:1 för kant, 3:1 för fält; nås inte överalltNås inte i mörkt lägeKant ≥ 2:1 och fält ≥ 3:1 efter justering; ingen regel i källan
PassarBreda medborgartjänster med lagkrav på enkelhetHandläggarverktyg, assistentdrivna tjänsterIntern arbetsyta för medarbetare och chef, moduler i ett gemensamt skal
GemensamtProfilens färger som enda utgångspunkt, shadcn/ui-kontraktet, Raleway i rubriker, "färg är aldrig ensam bärare", AI föreslår och människan beslutar.

När väljer man C?

När målet är kommunens interna arbetsyta och nästa tjänst ska bli en modul i ett skal som redan finns, i stället för en ny webbplats. C har det A och B saknar: kod i drift, en lintregel som fungerar, ett modulkontrakt och en devportal där dokumentation är ett leveransvillkor. C saknar det A har: verksamhetsfärger, mörkt läge, högkontrast, kontrastregler för kanter och ytor, och de åtta e-tjänstmönstren i AGENTS.md.

Nästa steg

Tre vägar att ta C vidare i fas 2, beroende på vilket alternativ som väljs.

  1. C som tredje tema i samma pipeline. tokens.startsidan.json läggs i packages/tokens/src bredvid A:s tokens och byggs till en tredje CSS. Registryts komponenter får varianterna Chip, StatusRow och AiChip. Kostnad: lägst. Vinst: startsidans moduler och e-tjänsterna kan dela komponenter.
  2. A:s lägen in i C. C får mörkt läge, högkontrast, verksamhetsfärger och kontrastreglerna för kant och yta ur A:s tokens.json, utan att byta identitet. Gapen i avsnittet Tillgänglighet försvinner. Kostnad: medel. Vinst: startsidan når samma nivå som e-tjänsterna ska nå.
  3. C:s arbetssätt in i A. Systemet som data med id, uttömmande varianter, felindex, llms.txt och spec.json, samt modulkontraktet, förs över till design-system-repot. A:s AGENTS.md blir en rendering av data i stället för prosa. Kostnad: högst. Vinst: en källa för tre renderingar och en agent som inte kan hitta på en sjätte ton.
Beslut som behövs innan steg 4 i planen: ska statusfärgerna i C (green #12874e, amber #b06a1f, red #b3261e, alla utanför profilen) och A:s Juniskär som felfärg samordnas till en uppsättning? I dag betyder "grönt" tre olika saker i de tre alternativen: A:s success, B:s success och C:s statusgrönt, och i C är profilens Grönsta reserverat för AI.