Design system
The design system behind Murales PDC
Murales PDC is a free, mobile-first street art map of Playa del Carmen, Mexico, in English and Spanish. This is the system that keeps it consistent: one set of tokens for colour, type, radius and spacing, reused across the gallery, the map, the mural page, tours and the volunteer team area. Every text colour pair meets WCAG AA.
Principles
Five rules that decide the small things.
1
Be honest about uncertainty
A map of temporary art is always partly wrong. Every mural shows how sure we are (status), how exact the pin is (precision) and what has changed (history). Unconfirmed is a normal state, not an error.
2
Let the art lead
The interface stays quiet (warm cream, sea blue, white cards) so the murals provide the colour. Photos fill the frame, and every photo sits next to the artist’s name.
3
Make contributing lighter than consuming
No account, one photo, location filled in automatically. Reporting takes one tap. Changing the record needs proof on site.
4
Design for the street
44px tap targets, a 12px type floor, AA contrast in bright sun, light thumbnails on mobile data.
5
Build systems, not screens
One Tag, one Card, one pin, one token file, reused across gallery, map, mural page, tour and admin.
Colour
Cream and sea blue lead. The mural photos supply the rest. Tokens live in one file, and these values are read from it when the page is built.
Neutrals
bg
#F3F1EC
Page background. Warm cream.
surface
#FFFFFF
Cards and sheets.
groove
#E5E2DA
Borders, dividers.
ink
#18171A
Primary text.
ink-2
#5F5A62
Secondary text.
ink-3
#6F6A73
Tertiary text, placeholders.
Brand and accents
sea
#326A82
Primary brand colour, buttons.
sea-dark
#245970
Pressed and hover.
sea-tint
#E8F2F6
Light brand backgrounds.
marigold
#E39A2D
Tour badge and tour tray only.
marigold-tint
#FCEFD9
Tour backgrounds.
you
#2F6FEB
"You are here" dot.
Status
Status never relies on colour alone: each state also has its own dot shape, so it works in bright sun and for colour-blind users. Red is for errors only.
Verified
#0A7560 on #E4F3EF
Confirmed on site.
Unconfirmed
#8A5608 on #FBF0DC
Also used for Changed.
Removed
#6038A0 on #EEE6F7
Wall painted over. Kept as a record.
Error
#9E2222 on #F9E5E5
Errors and delete actions only.
The one Tag component
DM Sans 600, 12px, pill. Filled dot: verified. Dashed ring: unverified. Ring: changed. Cross: removed.
Contrast
Every text pair meets WCAG AA (4.5:1). The lightest grey went from 2.4:1 to 4.7:1. Ratios below are calculated from the live tokens.
| Pair | Example | Ratio | AA |
|---|---|---|---|
| Body text on page #18171A on #F3F1EC | Aa | 15.82:1 | Pass |
| Secondary text on page #5F5A62 on #F3F1EC | Aa | 5.95:1 | Pass |
| Tertiary text on page #6F6A73 on #F3F1EC | Aa | 4.67:1 | Pass |
| Tertiary text on cards #6F6A73 on #FFFFFF | Aa | 5.27:1 | Pass |
| White on sea (buttons) #FFFFFF on #326A82 | Aa | 5.97:1 | Pass |
| Sea on sea tint #326A82 on #E8F2F6 | Aa | 5.25:1 | Pass |
| Verified tag #0A7560 on #E4F3EF | Aa | 4.93:1 | Pass |
| Unconfirmed tag #8A5608 on #FBF0DC | Aa | 5.45:1 | Pass |
| Removed tag #6038A0 on #EEE6F7 | Aa | 6.73:1 | Pass |
| Error tag #9E2222 on #F9E5E5 | Aa | 6.42:1 | Pass |
| Ink on marigold #18171A on #E39A2D | Aa | 7.59:1 | Pass |
Type
Two fonts, self-hosted. Syne for display at 20px and up, DM Sans for everything else. Nothing is under 12px.
40px · --fs-40
Display
Syne 800 · Landing hero only
28px · --fs-28
Screen title (h1)
Syne 800 · One per screen
20px · --fs-20
Sheet title (h2)
Syne 700 · Display font stops at 20px and up
16px · --fs-16
Body, inputs, card titles
DM Sans 400 / 600 · 16px stops iOS zooming into inputs
14px · --fs-14
Secondary text, buttons
DM Sans 500 / 600
13px · --fs-13
Captions, meta
DM Sans 400
12px · --fs-12
Tags, tab labels
DM Sans 600 · Absolute minimum. Nothing is smaller.
Shape and space
A 4px grid. Radius and spacing have roles, so components use names like panel and card instead of raw numbers.
Radius
r-inset · 8px
Thumbnails, small chips
r-panel · 16px
Card photos, inputs, panels
r-card · 24px
Pin card, tour list
r-sheet · 32px
White sheet on the mural page
full · 9999px
Pills, round buttons
Spacing and sizes
space-gutter · 16px
Screen edge
space-grid · 12px
Between gallery cards
space-row · 20px
Between gallery rows
control-h · 44px
Minimum hit area for any control
field-h · 48px
Buttons, inputs, search
Elevation
Map pins
Pins are 40px photo discs inside a 44px tap area. A solid ring carries the status. Pins that are too close are grouped into a count. There is no legend: the colour and shape rules above are the legend.



Murals shown: Senkoe, Theanunaki and @peokmancilla. Credit the artist next to every photo.
Components
Reused across gallery, map, mural page, tour and the team area.
Buttons (48px, pill)
Sea for the main action, outline for secondary, marigold for tours only.
Mural card (4:5 photo, text below)

Frida
Theanunaki
Centro · 350 m
A warm soft-light tint makes photos shot in different light feel like one set. Only murals that are not verified carry a tag.
Accessibility
Built for someone standing in the street: one-handed, in bright sun, on mobile data.
AA contrast
Every text pair is at least 4.5:1. The lightest grey was 2.4:1 and is now 4.7:1.
44px tap targets
Every control has at least a 44px hit area. Primary buttons and inputs are 48px.
12px type floor
Nothing is smaller than 12px. Inputs are 16px so iOS does not zoom.
Not colour alone
Status uses a shape cue (filled, dashed, ring, cross) as well as colour.
Keyboard focus
A 3px sea outline with a 3px offset on every focusable element.
Reduced motion
Animations and press effects are switched off when the device asks for it.
Light on data
600px thumbnails (about 50 KB instead of about 500 KB) and self-hosted fonts.
Two languages
English and Spanish, switched with one toggle.