Start
Overview
What the mojakirija design system is, which file wins, and how to read a status.
Accepted· design/HANDOVER.md; docs/plans/design-system-site.mdThis 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
design/HANDOVER.mdis the authority. Where this site and HANDOVER disagree, HANDOVER wins and this site is the bug.design/tokens.cssis HANDOVER's transcription into custom properties. The token pages here are read from it at build time, so they cannot drift from it.apps/web/components/uiis 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.
- AcceptedIn
design/HANDOVER.md, or a board the owner approved. This is the rule. - ProposedDrawn on the canvas, waiting for the owner's vote. Not a rule; do not implement.
- ProvisionalA gap filled by a reasonable reading, marked so in the token file. Use it, expect it to move.
- RejectedVoted down. Kept so nobody draws it again.
- SupersededReplaced 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.