Design system · v1.1
How Mymer looks, reads and behaves.
Taken from the live app at app.mymer.it in November 2026. Names, values and wording are the app’s own: this page documents what ships and does not rename anything. Use the toggle above to see everything in light and dark.
Foundations
Tokens
Every value is a CSS custom property with the app’s own name. Components never use raw colours, so a theme is only a different set of values.
Logo
The colour symbol and the lowercase wordmark. The symbol is also the loading and thinking indicator: one spin when a page opens, a continuous 0.9s spin while the system works. Full rules are in the logo guidelines.
Lockup · symbol · thinking state (stops under reduced motion)
Surfaces
Text
Borders
Accent and agent
The accent is also the agent colour: whatever the assistant made is drawn in it.
Status
Status colours always come as a pair: a text colour and its tinted background.
Content tags
Labels for kinds of content. Pastels in light mode, deep tints in dark.
Overlays
Typography
Newsreader for titles and everything people read: course text, questions, answers and feedback. Inter for interface. Body size in the app is 14px.
--text-title-page · 2.125rem · Newsreader 500
--text-title-container · 1.3125rem · Newsreader 500
--text-title-card · 1.1875rem · Inter 600
1.3125rem · Newsreader 600 · 1.35
--text-studio-paragraph · 1.0625rem · 1.6 · Newsreader 400
.9375rem · Inter 600
--text-md · .875rem · Inter 400 (body default 14px)
--text-sm · .8125rem · Inter 400, fg-dim
| Token | Size | px | Sample |
|---|---|---|---|
--text-2xs | .6875rem | 11 | Aa |
--text-xs | .75rem | 12 | Aa |
--text-sm | .8125rem | 13 | Aa |
--text-md | .875rem | 14 | Aa |
--text-lg | 1rem | 16 | Aa |
--text-xl | 1.25rem | 20 | Aa |
--text-2xl | 1.5rem | 24 | Aa |
--text-3xl | 1.875rem | 30 | Aa |
--text-4xl | 2.25rem | 36 | Aa |
--text-5xl | clamp(2.25rem,5.2vw,3.5rem) | 36–56 | Aa |
| Token | Value |
|---|---|
--weight-regular / medium / semibold | 400 / 500 / 600 |
--leading-tight / normal / relaxed | 1.2 / 1.5 / 1.7 (reading text 1.6, questions 1.35, UI lines 1.4) |
--tracking-tight / label | -0.01em / 0.06em |
--measure-reading | 68ch. The Editor text column is 40rem. |
Spacing
A 4px base. Half-steps exist for dense interface.
| Token | rem | px | |
|---|---|---|---|
--space-0-5 | .125rem | 2 | |
--space-1 | .25rem | 4 | |
--space-1-5 | .375rem | 6 | |
--space-2 | .5rem | 8 | |
--space-2-5 | .625rem | 10 | |
--space-3 | .75rem | 12 | |
--space-3-5 | .875rem | 14 | |
--space-4 | 1rem | 16 | |
--space-5 | 1.25rem | 20 | |
--space-6 | 1.5rem | 24 | |
--space-8 | 2rem | 32 | |
--space-10 | 2.5rem | 40 | |
--space-12 | 3rem | 48 | |
--space-16 | 4rem | 64 |
Radius
--radius-xs
4px
--radius-sm
6px · small controls
--radius-md
10px · fields, menus
--radius-lg
14px · cards, lists
--radius-full
Pills, buttons
Elevation
Flat first. Shadows mark things that float: menus, notices and the selected card.
Motion tokens
| Token | Value | Use |
|---|---|---|
--ease-out | cubic-bezier(.22, .9, .24, 1) | Everything that moves |
--duration-med | 0.2s | Hover, press, small changes |
--duration-loop-spin | 0.9s | Symbol thinking spin (linear) |
--duration-loop-pulse | 1.4s | Waiting pulse |
--duration-loop-success | 0.5s | Done flash |
--duration-notice-linger | 6s | Notices stay this long |
Layout
| Token | Value | Part |
|---|---|---|
--sidebar-rail-width | 3.25rem | Icon rail |
--sidebar-width | 14.5rem | Main menu, expanded |
--studio-outline-width | 15.5rem | Outline |
--studio-right-width | 21.25rem | Chat and Needs you |
--studio-top-height | 3rem | Editor top bar |
--studio-measure | 40rem | Text column |
--projects-card-min | 18.75rem | Project card minimum width |
--size-control-sm / md / lg | 1.5 / 2 / 2.5rem | Control heights |
--z-sticky … --z-toast | 1100 · 1200 · 1300 · 1400 · 1500 | Sticky · overlay · modal · dropdown · toast |
Icons
Lucide, 24px grid, 2px stroke, round caps. Drawn at 14 to 18px and always in currentColor. An icon never carries meaning alone: give it a text label or an accessible name.
Components
Building blocks
Each is built from the tokens above. Hover, focus and press them.
Buttons
Pill buttons · 40px · 32px small
Icon buttons · 24 / 32 / 40px
Every icon button needs an aria-label. Minimum target 24px; 44px on touch.
Segmented control and tabs
View switch
Tabs with counts
Breadcrumb
Shows where you are in a project. Earlier levels are links, the current page is a pill with its type, the AI marker and the “Waits for you” dot. It is a real nav with an ordered list, and the current page has aria-current="page". In the Editor it sits in the top bar and animates in (see Editor mode).
Full
Floating, in the Editor
Narrow: middle levels fold into “…”
Rules
Up to three levels show in full. Beyond that the middle folds into a menu. Links shorten with an ellipsis, the current page never does. On touch, links are 44px tall.
Fields and composer
Search field · 46px
Focus draws a 1px inset border and a 3px halo. The field never changes size.
Chat composer
Chips, tags and status
AI-generated
Anything the assistant made gets the sparkle and the accent colour. Remove it only when a person has checked it.
Status
Content tags
List rows
Title in 600, meta in fg-dim at 13px. A type icon on the left, the AI marker after the title, hover is tint-1.
Project card
Combustion engines
1 module · 2 pages · changed Nov 12
You were in NA vs forced induction engines
Question
The core pattern. Questions are drawn like a page, in the serif. The right answer is marked with colour, a check and the words “Right answer”, so it never depends on colour alone. Each answer has its own explanation behind a quiet rule.
Correct. An NA engine has no compressor. Atmospheric pressure alone pushes air in as the engine draws it.
That describes a turbocharger. An NA engine has no such device and uses no compression.
Assistant and Needs you
Hi! What shall we make? Describe what you need, or add sources, and I’ll draft a proposal.
Needs you
Each item says what is waiting and where. “Go through” opens it. Nothing here resolves itself.
Notices
bg-elevated, shadow-lg, lingers 6s. Always dismissible, and pauses while focused or hovered.
Editor mode
Open the Editor and the menus step aside
Choosing “Editor” hides every menu so the material gets the room, puts the cursor in the text, and brings in a breadcrumb that tells you where you are. This is a live demo: it plays on its own, and you can also select “Editor” yourself.
Projects
Everything you are making. Pick one up where you left off.
Combustion engines
1 module · 2 pages · changed Nov 12
NA vs forced induction engines
Learning objectives
Select “Editor” in the menu, or press Replay.
What changes
Main menu (14.5rem), Outline (15.5rem) and the Chat panel (21.25rem) all collapse to zero. The text column settles at 40rem, centred. Nothing is lost: the content stays where it was.
Where focus goes
To the first editable block, with a visible focus ring and a caret. Screen readers hear “Menus hidden” and land in the text. Tab order starts in the document.
How to get a menu back
“Show the menu” in the top bar, the thin handles on either edge, or Esc. Hover or focus on an edge handle previews the menu without moving the text.
| Step | What happens | Timing |
|---|---|---|
| 1 Open the Editor | Pointer selects “Editor”. The item presses, then the page switches. | 0.9s travel · 0.6s ripple |
| 2 Menus collapse | Width eases to zero while content fades, so text never reflows mid-read. | 0.6s ease-out (fade 0.4s) |
| 3 Focus lands in the text | The first block takes the focus ring and a caret; the hint appears for a few seconds. | 0.3s after collapse |
| 4 Breadcrumb | Each level slides in from the left, one after another. | 0.5s each · 80ms apart |
Motion
Suggested animations for slow or important moments
Proposed, not yet in the app. Each one marks a moment where the system works, waits or hands something to a person. All use the existing motion tokens, and every demo has a still version under reduced motion.
Show that work is under way and what shape it will take. Lines appear in the order they will be filled, and the shimmer stops when text arrives.
Mark spin 0.9s linear · lines in 400ms, 300ms apart · shimmer 1.4s
Reading a PDF takes a moment. A real bar fills while it is read, then a check draws in the same row so nothing jumps.
Bar 1.3s ease-out · check draws 450ms
The AI marker steps aside and a check takes its place. The accent tint settles to the added colour. This is the moment a person takes responsibility, so it earns a small flourish.
Marker out 300ms · check in 400ms · tint 900ms
When an item is handled it folds away and the count rolls down. The queue shrinks in front of you, which feels like progress.
Item collapses 500ms · counter rolls 400ms
Exported
Nothing is published without you, so the end of an export is clear: the bar completes and “Exported” stays on screen.
Bar 1.3s · check pop 500ms
A soft accent sweep shows which block changed, so Undo and History never leave you guessing.
Sweep 1.2s ease-out
Rules for motion
Say what is happening
Motion explains a change or a wait. If it does not, remove it.
Quick and quiet
In-flow changes take 200 to 500ms with --ease-out. Loops are only for work in progress and stop when it ends.
Never block, always stop
Input stays live during any animation. Under prefers-reduced-motion loops stop and changes are instant. Anything longer than five seconds has a pause control.
Screens
The app, built from the tokens
Three screens rebuilt from the real app with the components above. They follow the theme toggle. On a narrow screen, scroll sideways.
NA vs forced induction engines
Learning objectives
Correct. An NA engine has no compressor. Atmospheric pressure alone pushes air in as the engine draws it.
Editor with all menus open: Outline on the left, the material in the middle, Chat and Needs you on the right.
Projects
Everything you are making. Pick one up where you left off.
Combustion engines
1 module · 2 pages · changed Nov 12
You were in NA vs forced induction engines
Back to NA vs forced induction enginesProjects: a card per project that brings you back to where you stopped.
Search
What you’ve made, from all your projects. Each material lives in one project.
Hi! What shall we make? Describe what you need, or add sources, and I’ll draft a proposal.
Sources and Materials: one search across everything, with the assistant alongside.
Terms
The app’s words
These are the words the app already uses. Keep them as they are in the interface, in documentation and on the website.
| Term | Meaning |
|---|---|
| Editor | The mode where you write and review a material. Menus collapse here. |
| Projects | Everything you are making. Shown as cards or a table. |
| Sources | Documents you have brought in. One source can be used in many projects. |
| Materials | What you have made, from all projects. Each material lives in one project. |
| Needs you | The queue of AI drafts that wait for a person to review them. |
| Waits for you | The small accent dot beside anything in that queue. |
| AI-generated | The sparkle marker on anything the assistant made. |
| Chat | Talk to the assistant. Scope is “Whole project” or the open page. |
| Outline | The tree of modules and pages in a project. |
| Learning objectives | What a material should let a learner do. Edited as plain blocks. |
| Create | Adds a new page or material to the project. |
| Show the menu | Brings the collapsed menus back. |
| Right answer | The marked correct option, with a check and the words. |
| Answer mode | Switch between one right answer and several. |
| History | Earlier versions, with Undo and Redo beside it. |
Accessibility
WCAG 2.2 AA, in the tokens
The colour pairs below are measured from the values above. Use these pairings and the contrast is already settled.
| Pair | Use | Light | Dark | Needs |
|---|---|---|---|---|
fg on bg-subtle | Body text | 17.16:1 pass | 17.22:1 pass | 4.5:1 |
fg-dim on bg-subtle | Meta, secondary | 6.15:1 pass | 8.44:1 pass | 4.5:1 |
fg-dim on bg-elevated | Meta on cards | 6.37:1 pass | 7.02:1 pass | 4.5:1 |
fg-faint on bg-subtle | Hints, placeholders | 4.90:1 pass | 6.00:1 pass | 4.5:1 |
fg-faint on surface-sunken | Hints on the document well | 4.57:1 pass | 4.99:1 pass | 4.5:1 |
accent on bg-subtle | AI marker, links, accent text | 4.58:1 pass | 6.95:1 pass | 4.5:1 |
accent-fg on accent | Primary button text | 4.83:1 pass | 6.51:1 pass | 4.5:1 |
add on add-bg | Right-answer label | 4.72:1 pass | 9.38:1 pass | 4.5:1 |
danger on danger-bg | Error text | 5.00:1 pass | 9.04:1 pass | 4.5:1 |
warning on warning-bg | Warning text | 5.64:1 pass | 9.51:1 pass | 4.5:1 |
info on info-bg | Info text | 6.29:1 pass | 8.22:1 pass | 4.5:1 |
structure on structure-bg | Structure tag | 6.46:1 pass | 8.32:1 pass | 4.5:1 |
audience on audience-bg | Audience tag | 6.14:1 pass | 7.70:1 pass | 4.5:1 |
border-strong on bg-subtle | Form borders (non-text) | 3.47:1 pass | 3.61:1 pass | 3:1 |
Rules
Focus
A 2px accent outline, 2px off the element, on every interactive control. Never remove it. Fields use the inset border plus halo.
Targets
24px is the floor (--size-control-sm). Use 32px by default and 44px on touch.
Colour is never alone
Right answer = colour + check + words. AI = sparkle + “AI”. Status dots always sit beside a word, and the “Waits for you” dot has a name.
Editor mode
Collapsed menus are removed from the tab order and hidden from screen readers. Focus moves to the text and the hint is announced politely.
Names and labels
Icon buttons get an aria-label. Tabs use role="tab" with aria-selected; toggles use aria-pressed. The breadcrumb is a nav with aria-current.
Reading
Keep text near 68ch (40rem in the Editor), use relative units, and make sure layouts survive 200% zoom and 320px width.
Website
How the website relates
mymer.it is a marketing site that borrows the app’s look. It should use the app’s values, with these differences on purpose.
| Thing | App (source of truth) | Website today | Direction |
|---|---|---|---|
| Accent, light | #c8461f | #E4552A with #B83A0C for text | Use #c8461f for all interface. Keep #E4552A only inside the logo symbol. |
| Accent, dark | #ff6e44 | #FF6E44 | Same |
| Text faint, light | #6b6d76 | #666A74 | Use the app value |
| Page background | #faf9f6 / #0d0e12 | Same | Same |
| Fonts | Newsreader + Inter | Same | Same |
| Radius | 6 / 10 / 14px, pills | 10 / 16 / 28px, pills | The website may stay rounder; keep pills for buttons |
| Icons | Lucide, 2px | Few, drawn inline | Use Lucide when icons are added |