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.
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.
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.
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
| Del | Källa i repot startsidan | På den här sidan |
|---|---|---|
| Tokens | packages/tokens/src/theme.css, Tailwind v4 @theme med shadcn-kontrakt | Färg, typografi och form; kopierad som globals.startsidan.css och härledd till tokens.startsidan.json |
| Primitiver | packages/ui/src: Card, Chip, AiChip, Btn, StatusRow, ListRow, Progress, Avatar, MoreLink, Table ovanpå shadcn/ui | Primitiver |
| Mönster och ytor | apps/web/src/app/dev/ui/system/poster.ts och skalets shell.css | Mönster, Ytor |
| Regler | regler.ts: R1–R10, felindex, checklista; lintregeln inga-hardkodade-designvarden | Regler och felindex |
| Designfacit | docs/startsidan-prototyp-v3.html, felanmalan-poc.html, utvecklingsarende-prototyp.html, it-support-prototyp.html | Ytor |
| Beslut | ADR-008 shadcn som komponentgrund, ADR-009 designsystem som data, ADR-010 devportal | AI-native |
Principer
Systemet har tio bärande regler i prioritetsordning. De fem som formar utseendet:
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
| Token | Värde | Betydelse | Kontrast |
|---|---|---|---|
| ink | #1f1f25 | Brödtext och rubriker | 16,4:1 mot kort, 14,4:1 mot sida |
| ink-soft | #4a4a55 | Metatext, andrahandsinformation | 8,7:1 mot kort, 7,7:1 mot sida |
| ink-faint | #5f6b75 justerad | Platshå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 | #fff | Kortets botten | 1,14:1 mot sida. Kortet bärs av skugga och ram |
| page | #edf1f5 | Sidans botten, rader inuti kort | |
| page-deep | #e4eaf0 | Ett steg mörkare botten för helbreddsband | 1,07:1 mot sida, 1,21:1 mot kort |
| border | #a5b1bc justerad | Kortets ram, tunna avdelare. Källan har #dde3e9 (1,29:1). | 2,2:1 mot kort, 1,9:1 mot sida |
| border-strong | #76828d justerad | Ram 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 | #eef0f2 | Dämpad chipbotten, listavdelare | |
| muted-tx | #5a6470 | Text på dämpad botten | 5,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.
| Token | Värde | Betydelse | Kontrast |
|---|---|---|---|
| blue | #005595 | Primärknapp, avatar, aktiv markering. Profilens Vattjom. | 7,7:1 med vit text |
| blue-h | #004070 | Hover på primärknapp. Mörknar, blir inte genomskinlig. | 10,7:1 med vit text |
| blue-bg | #eaf1f8 | Ljus botten: hover på rader, info-chip | |
| blue-acc | #cfe0ec | Accentram, kort vid hover | 1,35:1 mot kort |
| blue-tx | #004c85 | Länktext, text på blue-bg | 8,9:1 mot kort, 7,8:1 mot blue-bg |
| blue-lift | #1472b8 | Identitetsblå mot mörk platta: avatar i sidopanel och fokuslägets topprad | 5,1:1 med vit text, 2,2:1 mot sidopanelen |
| sidebar | #003c69 | Endast sidopanelens botten | 11,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.
| Token | Värde | Betydelse | Kontrast |
|---|---|---|---|
| green | #12874e | Klart. Statusgrönt, inte AI-grönt. | 4,0:1 som kant mot sida |
| green-bg / green-tx | #e8f4ec / #0c6a3c | Chip tone="ok", nyckeltalsvärde som är bra | 5,9:1 i chip, 6,7:1 mot kort |
| amber | #b06a1f | Vä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 / #8a5117 | Chip tone="warn" | 5,6:1 i chip |
| red | #b3261e | Tidsgräns passerad, avvikelse. Kant, chiptext, destruktiv knapp. | 5,8:1 som kant mot sida, 6,5:1 med vit text |
| red-bg | #fceceb | Chip tone="avv", text i red | 5,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.
| Token | Värde | Betydelse | Kontrast |
|---|---|---|---|
| ai | #00733b | AI-knapp, AI-märke, AI-fältets fokusram. Profilens Grönsta. | 6,0:1 med vit text |
| ai-deep / ai-tx | #00592d | Hover på AI-knapp; text på ai-bg | 8,5:1 med vit, 8,0:1 mot ai-bg |
| ai-bg | #f1f9f5 | Botten på AI-tonade kort och chips | 1,07:1 mot kort |
| ai-acc | #c9e4d7 | Tonad ram på AI-ytor utan interaktion | 1,35:1 mot kort; därför ny token nedan för kanter som ska synas |
| ai-line | #2f8f5e ny | Kant 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 |
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.
| Namn | Värde | Används till |
|---|---|---|
| text-eyebrow | 1.2rem (12px) justerad | Versal etikett över nyckeltal. Källan har 1.1rem (11 px), under systemets egen minimigräns. |
| text-xs | 1.2rem (12px) | Metatext, chips, sidfot |
| text-sm | 1.4rem (14px) | Radrubriker, knappar |
| text-base | 1.6rem (16px) | Brödtext |
| text-h2 | 1.7rem (17px) | Kortrubrik, sätts av Card |
| text-lg | 1.8rem (18px) | AI-fältets inmatning, ingress |
| text-kpi | 3rem (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.
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>
- Behörighet HeromaInkom 12 mars · IT-supportVäntar
- Ny datorBeställd 3 marsKlart
- PasserkortTidsgräns 20 marsFörsenad
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>
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>
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>} />
- 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
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>
- Utvecklingsplan 2026Uppdaterad 12 marsVäntar
- Ledarskapsprogram, steg 2Klart 8 septemberKlart
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.
Tre ärenden väntar på dig, varav ett har passerat sin tidsgräns. Rehabärendet har ett utkast klart att granska.
// 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.
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.
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.
| Regel | Lyder | Därför |
|---|---|---|
| R1 | Grö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. |
| R2 | Allt AI-genererat märks synligt med AiChip. | Märkningen är ett löfte till användaren, inte en dekoration. |
| R3 | Blått betyder identitet. Avvikande färg betyder status. | En avatar i rött skulle läsas som att personen är försenad. |
| R4 | Fä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. |
| R5 | Statusfä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. |
| R6 | Moduler skriver Tailwind-utilities. shell.css ägs av skalet. | Skalets krom är porterad 1:1 från prototypen. |
| R7 | Server components som default. | Modulerna hämtar sin data på servern. |
| R8 | Varje kort får en tillgänglig rubrik via headingId. | Utan den är kortet en namnlös region för skärmläsaren. |
| R9 | Svenska i all UI-text, i visade props-värden och i commit-ämnen. | Blandat språk läcker igenom i demolägen. |
| R10 | TypeScript 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.
| Fel | Rätt | Varför |
|---|---|---|
bg-ai-bg på ett kort som visar "Klart" | <Chip tone="ok">Klart</Chip> på ett vanligt kort | AI-grönt och statusgrönt har olika betydelse (R1). |
text-[#005595] | text-blue | Hårdkodad färg går förbi tokens (R4). Fångas av lint. |
text-[14px] | text-sm, eller rem när skalan inte räcker | px bryter skalningen vid ändrad textstorlek (R4). |
| shadcns Button direkt | <Btn> ur @startsidan/ui | Btn 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 text | Samma 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 bredvid | Identitet 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.
| Yta | Form | För vem |
|---|---|---|
/dev/ui | Sida med levande exempel, renderade med samma primitiver som modulerna | Människan |
/dev/ui/spec.json | JSON, otidsstämplad så att två anrop går att diffa | Verktyg |
/dev/ui/llms.txt | Plattext på 25 kB, hela systemet i ett sammanhangsfönster | Modellen |
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.
// 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
sectionvia headingId. Sidopanelens aktiva länk bäraria-current="page". Rollväljaren använderaria-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-motionstä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.
| Gap | Källan | Justerat | Krav |
|---|---|---|---|
| Fältkant och ghost-knappens ram | border-strong #c3ccd4, 1,6:1 | #76828d, 3,9:1 mot kort och 3,5:1 mot sida | WCAG 1.4.11, 3:1 |
| Kortram | border #dde3e9, 1,29:1 | #a5b1bc, 2,2:1 mot kort | Systemregel A: kant ≥ 2:1 så att kortet syns när skuggan försvinner |
| AI-fältets och AI-ytornas kant | ai-acc #c9e4d7, 1,35:1 | Ny token ai-line #2f8f5e, 4,0:1; ai-acc behålls för tonade ramar utan interaktion | WCAG 1.4.11, 3:1 |
| Platshållartext | ink-faint #9aa3ad, 2,6:1 | #5f6b75, 5,5:1 | WCAG 1.4.3, 4,5:1 |
| amber som text | amber #b06a1f, 4,3:1 som nyckeltalsvärde | amber-tx #8a5117, 6,4:1; amber används bara som kant och punkt | WCAG 1.4.3, 4,5:1 |
| Små versaler | 11 px etiketter, sidopanelens gruppetiketter i 50 % vit (4,0:1), notisbricka 3,7:1 | 12 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.
| Aspekt | A · Sundsvall DS | B · Aurora | C · Startsidan |
|---|---|---|---|
| Status | Förslag | Förslag | I drift på start.sundsvall.dev, åtta moduler, två AI-flöden |
| Färg | Profilens hex exakt, en verksamhetsfärg per tjänst, fyra val | Profilens nyanser med höjd kroma, gradienter | Profilens hex exakt, en identitetsfärg (Vattjom), Grönsta reserverad för AI |
| Lägen | Ljust, mörkt, högkontrast, TV-test | Ljust, bläckmörkt, högkontrast, TV-test | Ljust |
| Typografi | Raleway + Inter, px-skala | Bricolage Grotesque + Geist | Raleway + Arial, rem-skala med 62,5 % rot |
| Komponentgrund | shadcn/ui, registry | shadcn/ui, registry, JSON-schema för generativt UI | shadcn/ui inkopierat, åtta primitiver med eget API, ingen registry |
| AI-regler | AGENTS.md med testbara påståenden | Fem UI-tillstånd för AI-innehåll | Data med id, varianter, villkor och felindex; llms.txt och spec.json; modulmanifest |
| Lint | Planerad: no-hex, no-palette, soft-surface-needs-border | Planerad | Finns: inga hex, inga px i className |
| Kontrast på kanter | Regel 2:1 för kant, 3:1 för fält; nås inte överallt | Nås inte i mörkt läge | Kant ≥ 2:1 och fält ≥ 3:1 efter justering; ingen regel i källan |
| Passar | Breda medborgartjänster med lagkrav på enkelhet | Handläggarverktyg, assistentdrivna tjänster | Intern arbetsyta för medarbetare och chef, moduler i ett gemensamt skal |
| Gemensamt | Profilens 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.
- C som tredje tema i samma pipeline. tokens.startsidan.json läggs i
packages/tokens/srcbredvid 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. - 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å.
- 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.