---
title: "Overview"
status: accepted
source: "design/HANDOVER.md; docs/plans/design-system-site.md"
updated: "21.11.2026."
url: https://design.mojakirija.rs/
---

# Overview

Accepted · design/HANDOVER.md; docs/plans/design-system-site.md

What the mojakirija design system is, which file wins, and how to read a status.

This is the design system of **moja kirija**: the tokens, components, patterns and words the product is built from, for the people and the agents who build it. It is served from the product's own Next app, and every example on it is the component the app ships, not a look-alike.

## Which source wins

1. `design/HANDOVER.md` is the authority. Where this site and HANDOVER disagree, HANDOVER wins and this site is the bug.
2. `design/tokens.css` is HANDOVER's transcription into custom properties. The token pages here are read from it at build time, so they cannot drift from it.
3. `apps/web/components/ui` is the implementation. A component page renders that code.

## Status

Every page, token and rule carries a status, drawn as a word and a shape, never as a colour alone. A proposal inside an accepted page sits in a dashed block marked **Predlog · nije pravilo** and is never mixed into the rule text.

| Status | Meaning |
| --- | --- |
| Accepted | In `design/HANDOVER.md`, or a board the owner approved. This is the rule. |
| Proposed | Drawn on the canvas, waiting for the owner's vote. Not a rule; do not implement. |
| Provisional | A gap filled by a reasonable reading, marked so in the token file. Use it, expect it to move. |
| Rejected | Voted down. Kept so nobody draws it again. |
| Superseded | Replaced by a later decision, which the entry links to. |

## Principles

- **Calm.** One filled button per step; the alarm colour belongs to four exceptions and to late status.
- **State is a shape before it is a colour.** Every state survives greyscale.
- **An amount never moves.** No counting up, no transition on a figure.
- **Static things never look raised.** Cards, rows, tags and statuses carry a 1px line and stay flat; only buttons and inputs carry small layered shadows, and pressed goes down (accepted 21.11.2026).
- **One hand on a phone.** Nothing below 16px, nothing smaller than a 44px target.

## For agents

Every page has a Markdown twin at its URL plus `.md`, and `/llms.txt` lists them. See [Agents](https://design.mojakirija.rs/agents).
