When to use

Place matters on three pages: Find a Store, Fuel & Fleet (the same finder with fuel filters) and the Locations directory. Each pairs a list of stores with a map slot, and the two always show the same set: search or filter and both follow.

The list carries everything people act on: the address, whether the store is open, the fuels, Directions, Store details and ORDER HERE. The map is for orientation, so nothing on the page depends on it. That matters today, because no map provider is connected yet: the slot renders its own night panel with the number of locations, and the layout, data and selection are already final. No map vendor is chosen yet; when one is, its map plugs into the same slot and replaces the panel.

Two more pieces belong to this family: the nearby stores on every store page, and the Indiana dot map, a decorative map behind the Home story.

Anatomy

3 stores near you
Store 001 #001 0.4 mi
100 Main Street, Riverside, IN 46001 Open 24 hours
Fuel Unleaded 87 · 89 · 93 DieselE85
Directions Store details ORDER HERE
Store 002 #002 1.2 mi
200 Elm Avenue, Riverside, IN 46001 Open until 11 PM
Fuel Unleaded 87 · 89 · 93 Diesel
Directions Store details ORDER HERE
Store 003 #003 2.3 mi
300 Oak Road, Lakeview, IN 46002 Closed · Opens 6 AM
Fuel Unleaded 87 · 89 · 93 DieselRegular 88
Directions Store details
3 locations
Find a Store, desktop Result count · the list in 5 of 12 columns · the map slot in the other 7, 48 px apart, sticky under the header. The first result is selected: surface fill, and the map slot receives it as the selected store.
PartRule
CountUI type, a polite live region: 3 stores, 3 stores near you, 2 stores near “Riverside” · Diesel. It names the search and every filter that is on.
ListResults under ink hairlines, the first with one on top too. 5 of 12 columns from lg on Find a Store; on Locations the map starts at column 6, 24 px away.
Map slot7 of 12 columns. From lg it sticks 24 px under the header and is as tall as the screen minus the header and 48 px, so it stays in view while the list scrolls.
SelectionPointing at a result or moving keyboard focus into it selects it: the row fills with surface and the map receives that store as selectedId.
PinsOne per result, from the store’s coordinates: an id, the store name as its label, latitude and longitude.

Map slot

3 locations
Find a Store, phone 4:3 below lg. Night, 32 px corners, three rings at 10 %, the count at the top. The caption line at the bottom is left out here.
1 location
Locations, phone 4:5 below lg on the Locations directory: the taller slot suits a phone held upright.
PartRule
Panelnight with pastel text, media radius (32 px), 32 px padding. Flat: no shadow, no texture.
RingsThree circles centred on the panel, 160 %, 100 % and 45 % of its width, a 1 px line in the text color at 10 %. The rings are the only decoration and stand in for distance from a point.
CountUI type with an 18 px map pin: 1 location, 3 locations. It follows the results.
CaptionOne line in caption type, at most 28 characters wide, saying that the interactive map is not connected yet.
RegionA labelled region, Store map, so screen readers can find it and skip it.

When a provider is connected

The provider is a single component that receives the pins, the selected store, a way to select a store and the region’s name, and fills the slot at the size the page gives it. The contract already carries selection both ways: the list tells the map which store is selected, and the map can select a store in the list. How the map itself looks (ground, pins, the selected pin) is not designed yet and is not part of this page.

Store results

Store 002 #002 1.2 mi
200 Elm Avenue, Riverside, IN 46001 Open until 11 PM
Fuel Unleaded 87 · 89 · 93 Diesel
Directions Store details ORDER HERE
Result Find a Store. Name and number, distance after Use my location, address, live status, fuels, then the actions.
Store 003 #003 2.3 mi
300 Oak Road, Lakeview, IN 46002 Closed · Opens 6 AM
Fuel Unleaded 87 · 89 · 93 DieselRegular 88
Directions Store details
Selected Under the pointer or keyboard focus: surface fill from hairline to hairline, and the map slot receives the store as selected.
PartRule
Row24 px top and bottom, 20 px at the sides, an ink hairline below. The fill reaches the hairlines; the content never does.
NameLilita One, display-s, with the store number after it in UI type: #002.
DistanceUI type, tabular figures, top right. Only after Use my location, which sorts by distance on the device.
FuelFuel eyebrow, then pastel tags in caption type, 14 px corners, 4 by 10 px: Unleaded 87 · 89 · 93 on Find a Store, then Diesel, E85 or Regular 88 when the store has them. On Fuel & Fleet, Unleaded is left out of the tags, since the fuel filter is above.
ActionsUnderlined at 2 px, UI type, 44 px tall, 24 px apart. Directions opens a map app in a new tab (up-right arrow). ORDER HERE only for stores with a Family Express Kitchen.
Store 001 0.4 mi
100 Main Street, Riverside, IN 46001 Open 24 hours Family Express Kitchen Car Wash Fuel Pet Wash
Store details Directions
Locations directory row The Locations page version: services with their pictograms instead of fuels, Store details then Directions. 28 px top and bottom.

On Locations the store name is itself the link to the store page; its underline fades in on hover. Services are listed in one order everywhere (Family Express Kitchen, Car Wash, Fuel, Pet Wash) with 16 px pictograms at stroke 1.75 (Iconography).

Store status

Open 24 hours
Open, all day
Open until 11 PM
Open, closes later
Closed · Opens 6 AM
Closed
Before the clock An empty line of the same height (outlined here).

Status is computed in the store’s own time zone, from its weekly hours, on the device: never while the page is built, so it is always current. Open is a 10 px leaf dot, the one place green carries meaning; closed is a 10 px ring in the text color. The label always says what happens next: Open until 11 PM, Closed · Opens 6 AM, Closed · Opens tomorrow 6 AM. In the store chooser it is set in caption type.

Nearby stores

Store 002 1.2 mi
200 Elm Avenue, Riverside, IN 46001 Open until 11 PM
Nearby store
Store 004 3.1 mi
400 Maple Lane, Lakeview, IN 46002 Open until 7 PM
Hover The whole card is the link; it fills with surface.
Store 003 2.3 mi
300 Oak Road, Lakeview, IN 46002 Closed · Opens 6 AM
Closed

The last section of every store page, Other stores near the store’s city: the three closest stores by straight-line distance, as hairline cards with 24 px corners and 24 px padding (20 px on small phones), three across from md. No map: the distance on each card says how far. The section does not render when there is no other store.

Indiana dot map

Phones and tablets 12 % dots, centred behind the figures of the Home story.
From lg 20 % dots, the whole state on the right of the band, 86 % of its height.
PartRule
ShapeIndiana’s outline from public boundary data, kept whole. Never redrawn, cropped or rotated.
DotsA 9 px screen of 2 px dots in the section’s text color, at 12 % (20 % from lg), so the copy over it keeps its contrast.
MarkerValparaiso, where the first store opened in 1975: a 5 px paper dot and a paper ring, 1.5 px, that grows from 60 % to 240 % and fades every 2.4 s.
EntranceThe dots spread out from Valparaiso in a widening circle over 2.2 s on the expo-out curve as the band scrolls into view.
RoleDecoration only: hidden from screen readers and from the pointer. It is not a store map and shows no stores.

With reduced motion, or before scripts run, the map simply shows and the ring stays still.

Phones

Below lg the list and the map do not fit side by side, so a List / Map switch sits next to the result count: two 44 px buttons, 4 px apart, the active one in ink. The list is shown first.

3 stores near you List Map
Store 001 #001 0.4 mi
100 Main Street, Riverside, IN 46001 Open 24 hours
Fuel Unleaded 87 · 89 · 93 DieselE85
Directions Store details ORDER HERE
Store 002 #002 1.2 mi
200 Elm Avenue, Riverside, IN 46001 Open until 11 PM
Fuel Unleaded 87 · 89 · 93 Diesel
Directions Store details ORDER HERE
List
3 stores near you List Map
3 locations
Map

States

ElementDefaultHover or focusSelected
Find a Store resultPaperSelects the rowSurface fill; passed to the map slot
Locations rowPaper; name underline hiddenSelects the row; name underlinedSurface fill
Nearby cardPaper, ink hairlineSurface fill
List / Map switchPaper, 1 px inkInk fill, paper label
Map slotCount of the current resultsReceives the selected store

Fills change over 180 ms (--duration-fast); under reduced motion they change at once.

Sizes

ElementMeasure
Map slot, desktop7 of 12 columns, screen height minus the header and 48 px
Map slot, below lg4:3 on Find a Store and Fuel & Fleet, 4:5 on Locations
Map slot padding and corners32 px, 32 px
Result row24 px top and bottom (28 px on Locations), 20 px sides
Status dot10 px
Fuel tag4 by 10 px, 14 px corners, caption type
Actions, List / Map buttons44 px tall
Nearby card24 px padding (20 px on small phones), 24 px corners

Usage

Store 002 #002
200 Elm Avenue, Riverside, IN 46001 Open until 11 PM
Fuel Unleaded 87 · 89 · 93 Diesel
Directions Store details ORDER HERE
Correct Everything people need lives in the list: the map repeats where, never what.
1 location Tap a pin to see the hours, fuels and how to order.
Avoid Details only on the map: on a phone or with a screen reader they are out of reach.
3 locations
Correct The map slot stays night with pastel text, like the other dark fields.
3 locations
Avoid A map slot in red or a bright color: red is for ORDER FOOD alone.
  • Same set, both sides. The count, the list and the pins always come from the same filtered results.
  • Status in words. The dot is a cue; the label says Open until 11 PM. Never a dot alone.
  • Distance only when known. Distances appear after Use my location; without it, no store claims to be closest.
  • The dot map is not a store map. It marks Valparaiso only; never add pins, counts or other towns to it.

Accessibility

  • The map slot is a labelled region (Store map); the list holds every fact and action, so the map is never required.
  • Each result is an article named by its store, and its actions are described by that name, so Directions and Store details are never ambiguous out of context.
  • Links that open a map app say so: an up-right arrow and a hidden (opens in a new tab).
  • The result count is a polite live region, so new results are announced without moving focus.
  • Use my location explains in a hidden note that the location stays in the browser and is never sent or stored; errors (blocked, unavailable, timed out, unsupported) are spelled out in place.
  • The List / Map switch uses pressed buttons, and the selection follows keyboard focus as well as the pointer.
  • The Indiana dot map is hidden from assistive technology.

Source

Website
components/locations/MapPanel.tsxlib/maps/types.tscomponents/locations/StoreFinder.tsxcomponents/locations/LocationsExplorer.tsxcomponents/locations/StoreResult.tsxcomponents/locations/StoreCard.tsxcomponents/locations/ServiceList.tsxcomponents/locations/StoreStatus.tsxcomponents/locations/NearbyStores.tsxcomponents/media/IndianaDotMap.tsxcomponents/sections/StoryStats.tsx