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
| Part | Rule |
|---|---|
| Count | UI 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. |
| List | Results 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 slot | 7 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. |
| Selection | Pointing at a result or moving keyboard focus into it selects it: the row fills with surface and the map receives that store as selectedId. |
| Pins | One per result, from the store’s coordinates: an id, the store name as its label, latitude and longitude. |
Map slot
| Part | Rule |
|---|---|
| Panel | night with pastel text, media radius (32 px), 32 px padding. Flat: no shadow, no texture. |
| Rings | Three 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. |
| Count | UI type with an 18 px map pin: 1 location, 3 locations. It follows the results. |
| Caption | One line in caption type, at most 28 characters wide, saying that the interactive map is not connected yet. |
| Region | A 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
| Part | Rule |
|---|---|
| Row | 24 px top and bottom, 20 px at the sides, an ink hairline below. The fill reaches the hairlines; the content never does. |
| Name | Lilita One, display-s, with the store number after it in UI type: #002. |
| Distance | UI type, tabular figures, top right. Only after Use my location, which sorts by distance on the device. |
| Fuel | Fuel 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. |
| Actions | Underlined 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. |
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
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
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
| Part | Rule |
|---|---|
| Shape | Indiana’s outline from public boundary data, kept whole. Never redrawn, cropped or rotated. |
| Dots | A 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. |
| Marker | Valparaiso, 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. |
| Entrance | The dots spread out from Valparaiso in a widening circle over 2.2 s on the expo-out curve as the band scrolls into view. |
| Role | Decoration 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.
States
| Element | Default | Hover or focus | Selected |
|---|---|---|---|
| Find a Store result | Paper | Selects the row | Surface fill; passed to the map slot |
| Locations row | Paper; name underline hidden | Selects the row; name underlined | Surface fill |
| Nearby card | Paper, ink hairline | Surface fill | |
| List / Map switch | Paper, 1 px ink | Ink fill, paper label | |
| Map slot | Count of the current results | Receives the selected store |
Fills change over 180 ms (--duration-fast); under reduced motion they change at once.
Sizes
| Element | Measure |
|---|---|
| Map slot, desktop | 7 of 12 columns, screen height minus the header and 48 px |
| Map slot, below lg | 4:3 on Find a Store and Fuel & Fleet, 4:5 on Locations |
| Map slot padding and corners | 32 px, 32 px |
| Result row | 24 px top and bottom (28 px on Locations), 20 px sides |
| Status dot | 10 px |
| Fuel tag | 4 by 10 px, 14 px corners, caption type |
| Actions, List / Map buttons | 44 px tall |
| Nearby card | 24 px padding (20 px on small phones), 24 px corners |
Usage
- 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