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. 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. 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. 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. 4

    Design for the street

    44px tap targets, a 12px type floor, AA contrast in bright sun, light thumbnails on mobile data.

  5. 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

VerifiedUnverifiedChangedRemovedErrorPlaceRotating wall

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.

PairExampleRatioAA
Body text on page
#18171A on #F3F1EC
Aa15.82:1Pass
Secondary text on page
#5F5A62 on #F3F1EC
Aa5.95:1Pass
Tertiary text on page
#6F6A73 on #F3F1EC
Aa4.67:1Pass
Tertiary text on cards
#6F6A73 on #FFFFFF
Aa5.27:1Pass
White on sea (buttons)
#FFFFFF on #326A82
Aa5.97:1Pass
Sea on sea tint
#326A82 on #E8F2F6
Aa5.25:1Pass
Verified tag
#0A7560 on #E4F3EF
Aa4.93:1Pass
Unconfirmed tag
#8A5608 on #FBF0DC
Aa5.45:1Pass
Removed tag
#6038A0 on #EEE6F7
Aa6.73:1Pass
Error tag
#9E2222 on #F9E5E5
Aa6.42:1Pass
Ink on marigold
#18171A on #E39A2D
Aa7.59:1Pass

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

shadow-1 · surfaces
shadow-2 · floating

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.

Verified
Unconfirmed
Selected
3
Group
You are here

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)

Take me thereUpdate this muralCreate tour

Sea for the main action, outline for secondary, marigold for tours only.

Mural card (4:5 photo, text below)

Unverified

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.