Design

The rules and parts that make bharatlas.com and collect look and work as one. This page is built from the same tokens the sites use, so every value here is the real one.

Principles

  • A survey sheet. Grid paper behind the page, white sheets on it, edged in navy, with labels in monospace.
  • India’s colours, with jobs. Saffron acts, green means open, navy is the ink.
  • Readable by everyone. AA contrast, 44 px targets, visible focus, light and dark.
  • Light. System fonts, no images for decoration, small pages.

Colour

Colours are roles, not hex values: use the role, and both themes follow. Saffron is for actions and always carries navy text. India green marks what is open, free or verified. Chakra navy is the ink and the edge.

Every text role reads at 4.5:1 or more on every surface, in both themes, and edges and the focus ring at 3:1 or more (tested). Hairlines (--line, --line-bright) are decoration and never the only edge of a control.

RoleLightDarkUse
--bg
surface
#F3F6F1
ink 15.5:1
#0a0a0a
ink 16.9:1
Paper behind the page.
--bg-elevated
surface
#ffffff
ink 16.9:1
#15151a
ink 15.5:1
Panels, sheets, cards and the header on the paper.
--bg-card
surface
#E9EFEA
ink 14.5:1
#1a1a1f
ink 14.8:1
Hover and selected tint; raised sections.
--land
surface
#E6F2EA
ink 14.7:1
#13261C
ink 13.6:1
Land fill; the hover of a line button.
--accent-tint
surface
#FFF1E3
ink 15.2:1
#3A2410
ink 12.5:1
A pale saffron behind a selected choice.
--fg
text
#0B1B3F
15.5:1 on paper, 14.5:1 lowest
#ededed
16.9:1 on paper, 12.5:1 lowest
Body text and headings (chakra navy).
--brand-ink
text
#0B1B3F
15.5:1 on paper, 14.5:1 lowest
#ededed
16.9:1 on paper, 12.5:1 lowest
The wordmark.
--muted
text
#4B5563
6.9:1 on paper, 6.5:1 lowest
#9ca3af
7.8:1 on paper, 5.7:1 lowest
Secondary text: notes, counts, captions.
--muted-strong
text
#374151
9.5:1 on paper, 8.8:1 lowest
#d4d4d8
13.4:1 on paper, 9.9:1 lowest
Secondary text that needs more weight.
--accent
text
#1A2A6C
12.1:1 on paper, 11.3:1 lowest
#F5A04A
9.4:1 on paper, 7.0:1 lowest
Links.
--accent-strong
text
#0B1B3F
15.5:1 on paper, 14.5:1 lowest
#F28C28
8.1:1 on paper, 5.9:1 lowest
The focus ring; strong accents.
--brand-green
text
#0F7A45
5.0:1 on paper, 4.6:1 lowest
#1FA463
6.2:1 on paper, 4.5:1 lowest
India green: open, free, verified; map-sheet labels.
--ok
text
#157236
5.5:1 on paper, 5.2:1 lowest
#4ade80
11.4:1 on paper, 8.4:1 lowest
Success.
--warn
text
#a14a0b
5.5:1 on paper, 5.1:1 lowest
#fbbf24
11.9:1 on paper, 8.7:1 lowest
Warning: large files, pending review.
--err
text
#b91c1c
5.9:1 on paper, 5.5:1 lowest
#f87171
7.2:1 on paper, 5.3:1 lowest
Errors; the non-commercial label tint.
--accent-fill
fill
#F28C28
text 6.9:1
#F28C28
text 6.9:1
Saffron: the primary action. Always navy text, never white.
--accent-fill-hover
fill
#E8730C
text 5.5:1
#F5A04A
text 8.1:1
The primary action on hover.
--on-accent-fill
on-fill
#0B1B3F
6.9:1 on saffron
#0B1B3F
6.9:1 on saffron
Text on saffron.
--edge
edge
#0B1B3F
15.5:1 on paper
#C8D0E3
12.8:1 on paper
The survey-sheet edge on controls, cards and the header.
--line
decor
#D5DED7
1.3:1: never the only edge
#262626
1.3:1: never the only edge
Hairline between rows. Never the only edge of a control.
--line-bright
decor
#B8C4BC
1.7:1: never the only edge
#404040
1.9:1: never the only edge
A stronger hairline. Never the only edge of a control.
--grid
decor
rgba(18, 128, 74, .07)
decoration
rgba(63, 203, 126, .06)
decoration
Grid paper lines.

Type

System fonts only: nothing to download, and each phone reads in its own face. Labels on the map sheet use the monospace.

TokenValue
--font-sansui-sans-serif, system-ui, -apple-system, "Segoe UI", "Inter", sans-serif
--font-monoui-monospace, "SF Mono", "Cascadia Mono", Menlo, Consolas, monospace

Sizes

Ten steps; every font size on both sites is one of them (tested).

  • --fs-xs 12pxIndia’s open atlas
  • --fs-sm 13pxIndia’s open atlas
  • --fs-base 15pxIndia’s open atlas
  • --fs-md 16pxIndia’s open atlas
  • --fs-lg 18pxIndia’s open atlas
  • --fs-xl 22pxIndia’s open atlas
  • --fs-2xl 24pxIndia’s open atlas
  • --fs-3xl 32pxIndia’s open atlas
  • --fs-4xl 44pxIndia’s open atlas
  • --fs-display 72pxIndia’s open atlas

Weights

  • --fw-regular 400India’s open atlas
  • --fw-medium 600India’s open atlas
  • --fw-bold 750India’s open atlas
  • --fw-heavy 850India’s open atlas

Line heights

TokenValueUse
--lh-tight1.15Page and section titles
--lh-snug1.35Labels and short lines
--lh-base1.55Body text
--lh-loose1.65Code and dense tables

Spacing

A 4 px grid. Gaps, padding and margins take a step from this scale.

  • --sp-1 4px
  • --sp-2 8px
  • --sp-3 12px
  • --sp-4 16px
  • --sp-5 20px
  • --sp-6 24px
  • --sp-7 32px
  • --sp-8 48px

Corners, borders and shadows

Buttons and fields have 4 px corners (--radius-sm). Cards, sheets and panels take a step from the scale. Chips and filters are pills. A dot can be round (50%). No other corner values (tested).

  • --radius-sm 4px
  • --radius-md 6px
  • --radius-lg 8px
  • --radius-xl 12px
  • --radius-pill 999px

Borders

The navy edge outlines controls, cards and the header; a hairline only separates rows.

TokenValue
--border-edge1.5px solid var(--edge)
--border-line1px solid var(--line)

Elevation

Hard offset shadows only, no blur: the sheet lifts off the paper like a printed map. The primary action casts one and presses into it.

  • --shadow-sm
    3px 3px 0 var(--edge)
  • --shadow
    4px 4px 0 var(--edge)
  • --shadow-sheet
    0 -1.5px 0 var(--edge)

Layers, motion, breakpoints and icons

Layers

Named stacking layers, lowest first. Use the name, not a number.

TokenValueUse
--z-raised1A card over its neighbour
--z-map-ui5Controls over the map
--z-sticky10Sticky bars
--z-sheet16Bottom sheets and panels
--z-popover20Popovers and toasts
--z-dialog50Dialogs and viewers
--z-skip1000The skip link

Motion

Short and functional: a sheet slides, a button presses. With reduced motion on, nothing slides, pings or spins, and the map on bharatlas.com jumps instead of flying (tested).

TokenValue
--dur-fast120ms
--dur-base200ms
--dur-slow320ms
--easecubic-bezier(.2, .7, .3, 1)

Breakpoints

Three widths. CSS cannot read a custom property in a media query, so these live in the token module as numbers.

NameWidthWhat changes
sm640 pxPhones: the nav folds into a menu, the map toolbar moves to the bottom
md900 pxTablets: the tagline goes, the theme index becomes a row of chips
lg1100 pxWide screens: the page column stops growing

Icons

Line icons in currentColor, at one of three sizes.

  • --icon-sm 16px
  • --icon-md 20px
  • --icon-lg 24px

Buttons

  • Primary (.btn .btn--fill): saffron with navy text, the navy edge and a hard offset shadow; it presses into the shadow. One primary action per area: the hero, a panel, a dialog.
  • Secondary (.btn .btn--line): white with the navy edge; land green on hover. Everything else that is a button.
  • Map toolbar (.tbtn): its own spec, compact and in a row over the map. On phones it stacks the icon over the label.
  • Buttons have 4 px corners and a 750 weight label in sentence case that says what happens: “View map”, not “Click here”.
  • Chips and filters are pills and are not buttons: they choose, they do not act.
  • Every target is at least 44 px tall on touch screens.
KindDefaultHoverFocusPressedDisabled
Primary
Secondary
Toolbar

Chips, badges and fields

Chips

Pills with the navy edge; the chosen one takes the saffron tint.

Badges

Small monospace labels. Every layer shows its licence; a non-commercial layer also says “Non-commercial only” in a red tint, wherever it is listed.

CC-BY-4.0 CC-BY-NC-4.0 Non-commercial only Stable Soon

Search

One field with the search icon, the navy edge and the offset shadow; the ring shows on focus.

Fields

A visible label above, 44 px tall, the navy edge. An error turns the edge red and says how to fix it, under the field.

Enter a year, like 2025.

Accessibility

  • Targets: at least 44 by 44 px on touch screens.
  • Focus: a 2 px --accent-strong outline, 2 px out, on every focusable thing. Never removed, only restyled.
  • The current page in the nav carries aria-current="page"; its style keys on that, so what you see is what a screen reader hears.
  • Reduced motion: no slides, pings or spins; spinners stand still; the map jumps.
  • Forced colours (Windows contrast themes): the primary action becomes Highlight, the current page is underlined, focus keeps its outline.
  • Colour never carries meaning alone: a status also has a word or a symbol, a link in text is underlined.
  • Light and dark follow the device. At 390 px wide no page scrolls sideways.

Words and numbers

  • Say layer and theme. “Category” belongs to the API and the code; the internal word for the full list never shows.
  • Sentence case for every label, heading and button. Nothing set in capitals.
  • No em-dashes: use a comma, colon, full stop or brackets.
  • Numbers in the Indian way, en-IN: 5,84,615, 2,94,09,120. Large counts may read 39.5k in tight spaces.
  • Dates read 21 Nov 2026; the machine form (2026-11-21) goes in the datetime attribute. The “Updated” line on layer rows still shows the machine form (planned).
  • An empty value reads “n/a”.
  • Credit the source and show the licence on every layer; a non-commercial layer says “Non-commercial only” on its card, in the API and in the MCP.

Maps and data

Numbers on a map use one hue, light to dark green, up to five steps, safe for colour-blind readers. Places with no value are not filled; they are hatched in navy, so “no data” never reads as “low”.

  • #77BA8D
  • #4FA272
  • #2B8657
  • #17673F
  • #0B4729
  • No data

Layer lines and fills keep the theme’s colour; the map’s own controls take the panel tokens in dark mode.

Governance

Design version 1.0.0. Every token lives in one module, shared/tokens.mjs, with the brand in shared/brand.mjs. bharatlas.com and collect both build their tokens from it, and this page is built from it, so none of them can drift.

To change a token: edit the module, add a changelog entry and raise the version. A renamed token keeps its old name as an alias for one release. The tests below fail when a page breaks a rule.

TestWhat it holds
design-tokensBoth sites emit the token module, with no token of their own; theme-color is the paper
contrastEvery text role on every surface, text on saffron, edges and focus, both themes
type-scaleEvery font size is a scale step
design-lintsCorners from the scale, fonts from the two families, button classes, forced colours, en-IN numbers, transitions that name what they animate
survey-sheet, page-systemThe navy edge, offset shadow and grid paper; one page system
no-emdash, terminology, design-auditNo em-dashes, the site’s words, sentence case, 44 px targets
reduced-motionNothing moves when reduced motion is on
design-pageThis page shows the real tokens

Changelog

  • 1.0.0 (2026-11-21)
    • One token module for bharatlas.com and collect: the same names and values on both sites.
    • Status colours deepened in light mode so they pass AA as text on every surface.
    • India green as text deepened a shade (#0F7A45) to pass AA on the hover tints.
    • New scales: font families, weights, line heights, borders, z-index layers, motion, icon sizes.
    • collect names follow bharatlas.com: --card and --sheet are --bg-elevated, --surface is --bg-card, --accent-solid is --accent-fill, its old tint is --accent-tint.
    • theme-color and the app manifests match the paper (--bg).
    • Deprecated: --radius (use --radius-sm).

Planned

  • One shared component each for search, chips, sheets, popups, spinners, status messages, empty states and form states.
  • The map popup in dark mode.
  • Spacing, weights, shadows, layers, breakpoints and motion moved onto the tokens everywhere, with shrinking lists in the tests.
  • Icons in place of emoji in collect, and licence badges in collect’s layer picker.
  • One date format on layer rows.
  • collect’s map camera honours reduced motion, as bharatlas.com’s does.