The S/V Moonstruck logoStyle guide

Style guide

Every color, size, component and rule of the S/V Moonstruck site, shown as it ships. The specimens are the real components, and the numbers are read from the source.

Satellite view of the Virgin Islands

Drag the chart to pan

The itineraries hero chartNot for navigation

Moonstruck reads like the boat's own instrument panel on a night watch: a deep navy field, lit readings on it, an italic serif that speaks and small tracked capitals that annotate.

This page documents what index.html, assets/pages.css and tools/chart-pages.py ship. DESIGN.md holds the reasoning behind each rule named here; where the two disagree, the source is the truth. tools/build-docs.py writes the token values and contrast ratios into this page and lifts several specimens straight out of the generated pages.

Palette

Five colors: Moonstruck Navy for the field, Honeydew for the type and, at measured alphas, for everything quiet, Frosted Blue for the data, Punch Red for the one booking action and a stale reading, and Cerulean for the sea under the mark.

The five are the owner's, and nothing is mixed from them into a sixth hex: a panel, a well and a hairline are the five at an alpha over the field. Moonstruck Navy replaced Oxford Navy as the field on 2026-09-25 (the owner's ruling); it was already asset-bound to the charts and the sea texture (every satellite plate is toned to it), so the chart field is now the same navy as the rest of the page. Every value was measured against the field it sits on, not picked by eye. A new step inside a family is a design decision; a new hue is one to take to the client.

Field

Moonstruck Navy#061e45

Type

Honeydew#f1faee
the tint at 0.82rgb(241 250 238 / 0.82)
the tint at 0.7rgb(241 250 238 / 0.7)
the tint at 0.6rgb(241 250 238 / 0.6)
the rule tintrgb(241 250 238 / 0.16)

Data and action, a stale reading, and the sea

Frosted Blue#a8dadc
Punch Red#d7283a
Cerulean#457b9d

What each color is for

ColorTokensRole
Moonstruck Navy--ink-page, --ink-panel, --ink-well, --chart-navyThe whole field: the page, and the panels, cards, navigation bar, wells, footer and badges on it, which are told apart from it by their hairlines; the chart field and the sea plate too, since 2026-09-25. What shows behind an overscroll, and the browser's theme color.
Honeydew--cream, --cream-brightEvery line of type: headlines and large figures (--cream), and body copy, lists and UI text (--cream-bright). Two tokens for two roles, one color.
the tint at 0.82--text-softSupporting text, section leads and the base link color.
the tint at 0.7--text-muteMuted small print and the tracked label voice.
the tint at 0.6--text-faintThe text floor: a booked or turnaround day.
the rule tint--line-ruleHairlines at 0.16. The quietest edge is 0.08 (--line-soft), and the quiet button's plate is the tint at 0.08 too (--btn-plate).
Frosted Blue--cyan, --cyan-mutedThe measurements: chart pins and routes, key numerals, an open day, gauge fills, text selection, the focus ring. The palette has no darker blue to give the muted step, so both tokens take it.
Punch Red--rust, --actionThe one booking action, as a fill under a Honeydew label. A stale weather reading, as a wash, a border and its 24px figure, and the bands of the lifering on the 404 page. Never small type: it is under the floor on the field.
Cerulean--mark-sea, --mistThe sea at the foot of the mark, and the haze inside the rate table. A quiet shape, never type.

Translucent steps are written from the channel tokens, as in rgb(var(--tint-rgb) / 0.72). No type is set below the text floor.

  • The One Field RuleEvery section is Moonstruck Navy, the chart field and the sea plate included since 2026-09-25. There are no light, white or gray surfaces, and no second navy: a panel or a well is told from the page by its hairline and, where it needs more, a wash of the tint. The one light surface is the Where She Is chart, Honeydew by the owner's ruling.
  • The One Action RulePunch Red fills the single most important action in a view, the Charter Smarter booking link, and nothing else. The floating bar hides itself while the closing section's button is on screen, so two never share a viewport. The fill is --action, Punch Red under a Honeydew label at 4.6:1.
  • The Cyan Is Data RuleBeside the focus ring, Frosted Blue, the --cyan token, is reserved for what carries a measurement: chart pins and routes, key numerals, gauge fills, an open day. Never a heading, a border or a flourish.
  • The Lit and Unlit RuleA state that is off is drawn, not dimmed. An open day is lit with a Frosted Blue wash; a booked day keeps a hairline and strikes its numeral through; a turnaround day keeps the hairline alone. Each is still numbered at the text floor.

Fields and contrast

One dark world in one step. Depth comes from hairlines and washes of the tint, never from a second field color or a change of temperature.

There is no light section, and the site does not follow the device's light or dark setting (color-scheme: dark). Until September 2026 the site had a second, near-black palette, Night Watch, and a switch in the footer between the two; both are gone.

On the field

A week has shape and generosity.

Body copy takes Honeydew. Prose links take the tint at 0.82, and Honeydew on hover.

Annotation in the tint at 0.7

On a panel

A week has shape and generosity.

Panels, cards and the navigation bar are the same navy, held apart by a hairline. Type and links are the same.

Annotation in the tint at 0.7

Measured contrast

Computed from the shipped token values by tools/build-docs.py, with a translucent ink composited over its field first and rounded down to one decimal, so no pair is ever rounded up over a threshold. Text needs 4.5:1; large text and non-text marks such as the focus ring need 3:1.

SamplePairRatioUsed for
Aa HoneydewHoneydew on Moonstruck Navy15.3:1Every headline, figure, line of body copy and UI label on the field.
Aa HoneydewHoneydew on Moonstruck Navy15.3:1Type over a chart field.
Aa at 0.82Tint at 0.82 on the field10.6:1Supporting text and section leads.
Aa at 0.7Tint at 0.7 on the field8.0:1Muted small print and the tracked label voice.
12 at 0.6Tint at 0.6 on the field6.2:1The text floor: a booked or turnaround day.
Aa Frosted BlueFrosted Blue on Moonstruck Navy10.7:1Data, chart furniture and the focus ring.
7 pinMoonstruck Navy on Frosted Blue10.7:1Chart pins and key numerals.
Aa chosenMoonstruck Navy on Honeydew15.3:1A hovered dark button.
Aa BookHoneydew on Punch Red, the booking action4.6:1The one booking action.

The booking button was Punch Red until 2026-09-21, under a Honeydew label at 3.9:1 on the owner's original hex: no color in the five cleared 4.5:1 on it. It was Frosted Blue under Oxford Navy, which clears 8:1, from then until 2026-09-25, when the owner returned it to Punch Red and had the red itself deepened, keeping its hue, until the Honeydew label cleared 4.5:1 — one red, not two.

Pairs that are never used

Recorded so that nobody reaches for them.

SamplePairRatioInstead
Punch Red on Moonstruck Navy3.3:1Under the floor for small type and for a thin mark, either way round. Punch Red is a stale reading's wash, border and 24px figure.
Cerulean on Moonstruck Navy3.5:1A quiet shape under the mark, never type or a control's edge.
Honeydew on Frosted Blue1.4:1A Frosted Blue fill takes Moonstruck Navy.
Rule tint on the field1.5:1A rule color. Text takes the 0.6 step or better.
  • The Photographic Field RuleA section that carries a photograph is washed with rgb(var(--ink-page-rgb) / α) so the image settles back into the field: 0.88 on Captain360, 0.86 on rates. α is solved so cream type clears 4.5:1 over the photograph's brightest pixel. The tint's soft and mute steps never sit on the wash; they get a panel. Re-measure when a photograph changes.
  • The Wash Is Solved RuleA scrim over a photograph is solved against the navy it is made of, and every alpha in one is a token: the destination hero's is 0.5, 0.8 and 0.96, which puts the US Virgin Islands headline at 3.7:1 and its lede at 4.8:1 over the brightest sky, and the layout drawing shows at 0.32.
  • The Calendar Legibility RuleEvery calendar day state clears 4.5:1, and state is never carried by color alone: each day has hidden text, and on-hold days keep their stripe.

Type system

Three faces, three jobs: an italic serif for what is said, a roman sans for what is read, and tracked monospace capitals for what is annotated or pressed.

Aa

Playfair Display

Italic only, one variable file from 400 to 900. Headlines at 700, large figures at 900, and short accent lines inside components.

A week aboard Moonstruck 0123456789

Aa

Barlow

400 for everything read at length: body, leads, prose links. 500 for the drawer's links. The 300 cut is loaded but not used for running text, since a light weight thins out against a dark field.

Short sails, long afternoons 0123456789

Aa

IBM Plex Mono

The label voice, always uppercase and tracked: 400 for navigation, buttons, captions, chart furniture and calendar days; 500 for short standout labels and pin numbers.

Under sail · Book · 1 h 30 min

Six files carry all of it, served from this site (assets/fonts/, each family's license beside it); CSS may ask for nothing else, because a weight with no file is drawn at the nearest one. The families are reached through --font-display, --font-body and --font-label, whose stacks lead with a metric-matched stand-in (Georgia at 85.2% for Playfair, Arial at 94.4% for Barlow, Courier New for Plex Mono), so the swap to the webfont moves no line break.

  • The Three Voices RulePlayfair is italic, Barlow is roman, and IBM Plex Mono is small capitals. A roman Playfair heading, an italic Barlow paragraph or a lowercase mono label all read as mistakes. No uppercase eyebrow sits above a heading: the heading carries the section. Uppercase strings are written in sentence case in the source and transformed by CSS, so assistive technology reads words, not letters.
  • The Figures Are Readings RuleAny number a guest acts on (a rate, a length, a year, a day count) is set in Playfair italic 900 with lining tabular figures. Numbers inside running prose stay in Barlow.

Type scale

Roles are tokens, named for the job and not the value. Every size below is set live from its token.

Display--type-display
clamp(3rem, 8vw, 5.75rem)
leading 0.98 · hero only

Set sail.

Headline--type-headline
clamp(2.375rem, 9vw, 3.625rem)
leading 1 to 1.02

A captain, and a good deal more

Subhead--type-subhead
clamp(1.875rem, 7vw, 2.75rem)
leading 1.1

Open weeks at a glance

Title L--type-title-lg
2.125rem · leading 1.15

Also on the chart

Title--type-title
1.75rem · every card and entry heading

Norman Island to the Baths

Title S--type-title-sm
1.5rem · every tile title on a phone

Clearing in and out

Lead--type-lead
1.1875rem · leading 1.65
on five columns

Every charter aboard Moonstruck is planned around the people on board, so no two weeks are alike.

Serif text--type-serif
1.25rem · the floor for serif running text

The balance this charter was planned around, from its planning sheet. Yours is drawn to your own taste.

Body--type-body
1.0625rem · Barlow 400 · leading 1.65
45 to 75 characters

We head for the Baths for light swimming and a hike through the granite boulders, then on to Spanish Town for dinner ashore.

Body on navy--type-body-navy
1.125rem · Barlow 400 · leading 1.65
one step up on the deepest fields
Small--type-small
0.875rem · Barlow 400

per person, for the week

Label--type-label
0.75rem · IBM Plex Mono 400 · 0.16em tracking

1 h 30 min under sail

Standout label16px · IBM Plex Mono 500 · 0.08em tracking
badges only

Most popular

Figure48px · Playfair 900 · leading 1
a reading, so the display face
$4,100
  • The Optical Size RulePlayfair's x-height is 0.386em to Barlow's 0.460em, so the serif reads about a sixth smaller at the same pixel size. Serif running text is never set below Serif text (1.25rem), which is what sits level with 1.0625rem Barlow: Side by side: Barlow 17 · Playfair 20 · and Playfair 17, which is lost
  • The Heading Leads RuleA heading takes its space from above, not below, so it binds to the block it introduces instead of floating between two. --head-lead (1.25em) sits over a heading that follows content in the same flow; --head-trail (0.4em) sits under every heading. Both are em, so a subhead leads by more than a title. The lead only matches a heading that follows a sibling, because one that opens a container already has the container's padding over it. A definition list is a heading and its paragraph too, so it cannot sit on a grid gap, which would put a term as far from its own explanation as from the next entry. The rule Clearing in The term hugs its own explanation and keeps its distance from the entry above. On a grid gap Clearing in One gap between every child, so the term floats and reads as the tail of what came before.
  • The Dark Field RuleLight text on a dark field reads thinner than the same text on a light one. Body copy on the deepest fields steps up to Body on navy (1.125rem), and running text of 14px or smaller never drops below the tint's 0.66 step. Every body paragraph takes --leading-body; a list of one-line items may open to 1.8, where the leading is the space between items.
  • The Plain Figures RuleFigures here are data. Playfair's default old-style 1 and 0 read as letters, so body sets lining-nums site-wide and anything columnar adds tabular-nums beside it. The property is not additive: a rule that sets tabular-nums alone turns the old-style figures back on. $4,100 lining$4,100 old-style, never

The mark

One mark, in two inks: its own colors on a light ground, and Honeydew on the site's navy field, with its water in two bands: the tint over a Cerulean sea.

The S/V Moonstruck mark in its own colors
The S/V Moonstruck mark recolored to Honeydew, with a band of the tint over its Cerulean sea

The file is assets/Moonstruck-Logo.svg. It follows the name as it is lettered on the hulls: MOON cut out of a moon disc, then STRUCK beside it in light Jost capitals, with the two O's drawn as a pair of wayfarer sunglasses seen straight on. The cut-out letters and the lenses are real holes, which is what lets the file work as a mask. The water under the disc is two bands, as on the hull: a light blue-gray, then Moonstruck Navy. The disc's navy (#1f2b5b) and the band's blue-gray (#9db2cc) belong to the asset and sit outside the token set.

On the navy field the same file becomes a mask over a fill: Honeydew down to the gap above the water, the tint at its text-soft step from there, and --mark-sea for the sea. There is one file to maintain, and every ink is a token. The sea has a token of its own because the field decides it: the hull's Moonstruck Navy would sink into Moonstruck Navy, so the sea is Cerulean, the one mid blue in the palette and the sea on the app icon, a quiet shape at 2.6:1. The first stop sits at 75% of the height, inside the gap; the second, at 86.2%, falls inside the water, which the mask draws solid. It is not a CSS filter chain: iOS Safari does not clamp after every step, and drew the mark cyan.

background: linear-gradient(var(--cream-bright) 75%, var(--text-soft) 75% 86.2%, var(--mark-sea) 86.2%);   /* the water is below 75%, the sea below 86.2% */
mask: url("Moonstruck-Logo.svg") center / contain no-repeat;   /* with the -webkit- twin */
object-position: -999px 0;   /* the img's own pixels, out of the box */
WhereHeightInk
Homepage nav, over the hero60pxHoneydew and Cerulean water, by mask, on the photograph
Homepage nav once scrolled; every inner page's nav46pxHoneydew and Cerulean water, by mask
Footer46pxHoneydew and Cerulean water, by mask, at 90%
This guide's bar40pxHoneydew and Cerulean water, by mask

Beside it

The favicon: the mark on a rounded ink field The touch icon: the mark square to the edge
Paradise Yacht Management
The Charter Smarter mark
The Captain360 logo, reversed for a dark field
The British Virgin Islands logo in HoneydewThe United States Virgin Islands logo in Honeydew
Starlink

The favicon (assets/icon.svg) sets the mark in Honeydew, over a Cerulean sea, on a rounded field of Moonstruck Navy, the --ink-page that the pages' theme-color and the web manifest carry. tools/build-icons.py rasterizes that drawing into the rest: a 32px PNG, a 180px touch icon, the manifest's 192 and 512, a maskable 512 drawn smaller to sit inside Android's safe circle, and a flat black mask-icon.svg for a pinned Safari tab. Paradise Yacht Management's mark sits beside Moonstruck's in the footer at the same 46px; the Charter Smarter mark appears once, on the homepage's booking card, where it says where the booking button leads.

The two tourism boards' logos sit in the footer's Visit the islands row under the booking address, each linking to the board's site: the BVI Tourist Board's at 36px and the U.S. Virgin Islands Department of Tourism's at 30.3px, so the two take one footprint, 2,400 square pixels each, on both sites: the BVI logo is the squarer of the two (1.85:1 against 2.62:1), so it stands taller. They are the boards' own one-color files, painted whole in Honeydew by mask at 90% (img.tourism-bvi, img.tourism-usvi), like every partner mark in the footer.

Starlink's mark (assets/starlink.svg) follows the word in the homepage's specifications, on the Internet row: the symbol from Starlink's logo, without its lettering, masked to the words' own color, with its X at four-fifths of the capitals' height and its orbit rising past them ([data-starlink]); the comforts caption names the service in words alone. It never parts from the word at a wrap, and it adds nothing to the line's height. The brochures inline the same file, in their ink.

Captain360's lockup heads the homepage's Captain360 section and the tri-fold brochure's Captain360 panels. It is Paradise Yacht Management's artwork, redrawn as outlines from the bitmap on their site, and it comes as two files: assets/captain360.svg in its own three inks (gray #737373, orange #e15d27, blue #019ada) for a light ground, which is the one the tri-fold uses because it is printed on white, and assets/captain360-reversed.svg, the one used here, with the gray lettering in Honeydew because gray on this field reads as dirt. The orange and the blue belong to the asset and sit outside the token set, as the Charter Smarter mark's navy does. The lockup keeps clear of the booking action, and appears once to a view.

Grid and measure

A nine-column page grid: 1040px at most, a 32px gutter, and everything else derived from those two numbers.

Nine is chosen for the editorial 3 + 6 and 4 + 5 splits it allows; it is not a twelve-column utility grid. The grid governs page-level placement only: components subdivide freely inside their span, because the page's natural groupings (two destinations, seven days) do not divide by nine.

One column is 87px. The widths above are worked out from the tokens by tools/build-docs.py.

Margins and rhythm

TokenDesktop768px and belowUse
--section-xclamp(72px, 7.5vw, 120px)24pxThe horizontal page margin, everywhere: sections, nav, hero and footer. Above a phone it grows with the window, from 72px to 120px.
--section-y56px64pxDefault vertical section padding.
--section-y-lg96px64pxEmphasis: availability, and the inner pages' main sections.
--section-y-xl128px80pxThe closing booking section.
--gutter32px24pxBetween columns, and between most paired blocks.

Vertical rhythm goes lower on a phone, not higher.

Breakpoints

WidthWhat changes
1224px and upThe nine-column line exists: the first width at which --grid-max plus twice --section-x fits, derived, not chosen. Compositions that need it engage here and no earlier, or their bases overflow and wrap.
1223px and belowTwo-column compositions go fluid: 5fr to 6fr with an 8% alley.
1180pxThe seven nav links give way to the burger and its drawer. Written 73.75em, so a visitor with larger text gets the burger sooner.
1100pxThe itineraries hero copy leaves the chart and sits above it.
920pxThe Captain360 cards drop to one column.
900px, 800pxPassage plans and notes, then pilot entries, drop to one column.
768pxThe phone layout: margins and rhythm step down, grids go to one column, charts pan sideways, the floating bar becomes a row along the bottom.
600pxThe rate table turns each row into a party-size header over two season cells.
480px, 430px, 380px, 360pxSmall repairs: the hero headline's glass plate, the calendar to one month across, the footer address, the pictogram legend.
  • The Column Span RuleA new container takes a span token, never a hand-picked pixel width. If a block needs a width the scale does not offer, the scale is wrong: fix the tokens, not the block.
  • The One Margin RuleThe horizontal page margin comes from --section-x and nothing else. A full-bleed escape is written calc(-1 * var(--section-x)), so it tracks the margin.
  • The Shrinkable Track RuleA single-column grid is written minmax(0, 1fr), never a bare 1fr, which cannot shrink below its content. With a pannable chart inside, a bare track once ran a 390px phone page to 734px. When checking a phone layout, confirm that innerWidth equals the width you asked for.

Layouts

The compositions the pages are built from, drawn on the nine columns. Every split sums to nine, so edges land on the same column lines from section to section.

Blue blocks are photographs, navy blocks are charts, dark blocks are type, outlined blocks are panels. Below 1224px these go fluid, and at 768px each is a single column in source order, which is also the order a screen reader gets.

The boat: header

Six columns of headline and lede against a three-column round portrait.

The boat: feature field

Two four-column tiles with a derived one-column alley (dashed), opened and closed by full-measure plates.

Captain360

Three equal cards across the wide measure: the captain, what each charter includes, and what the captain does.

Passage plan

Four columns of chart, sticky below the nav, against five of log.

Chart index

On navy: six columns of chart against a three-column key; a chart too wide for that takes all nine, with the key beneath.

Pilot entries

Four columns of chart inset against five of text, mirrored on every second entry.

Notes

Reading the plan, and Between the anchorages: a heading and lede on four columns against a definition list on five.

Also on the chart

A three-column heading against the two cross links.

Buttons and controls

Square, tracked and quiet. Small, widely tracked uppercase labels with generous padding and a color swap on hover.

Every button is a link: the site has no form, so each action leaves for a call, an email or the Charter Smarter booking form, and an external one says so in its accessible name (“Book with Charter Smarter (opens in a new tab)”). These are the real .btn classes; the homepage draws the same buttons with inline styles.

On Moonstruck Navy: .btn-primary, .btn-dark, and the focus ring in Frosted Blue

On Moonstruck Navy: the closing section's actions. .btn-primary, .btn-ghost, and the ring in Honeydew

The floating action bar, over photography. Dark is 92% so it holds on any frame

ButtonFill and inkType and paddingWhere
PrimaryPunch Red, Honeydew (--action, --action-ink)12px, 0.18em tracking; 18 by 26px; 132px minimumBooking, once per view.
DarkThe tint at 8% (--btn-plate), Honeydew; opaque Moonstruck Navy in the floating barAs primaryCall and Email in the floating bar and under the calendar.
GhostA 1px tint outline at 50%, Honeydew14px, 2px tracking; 18 by 40pxSecondary actions on navy fields: Email, the phone number, hero jump links.

On hover the primary keeps its color and lights a 2px Honeydew bezel; Dark swaps to a Honeydew fill over 0.25s; the ghost firms its outline and takes a 10% wash. In the closing section the three actions share a 236px minimum width, so none reads as the runt.

Icon controls

Round is reserved for controls that are only an icon. Anything on imagery carries the Control shadow.

7 / 17 3

Carousel arrow 52px · lightbox arrow 56px · close 48px · counter chip · chart pin 24px · a 24px mark inside its 44px hit area

The divider knob (40px) and the map opener (34px) share the vocabulary; both are live on the inset under Components.

  • The Hit Area RuleA small target keeps its drawn size and grows an invisible 44px hit area from an ::after with a negative inset: the destination cards' text links, the footer's 24px social marks and its email address. Chart pins stay at their drawn size, because each has a full-height row in the key that does the same job, and padded pins on a crowded chart would steal each other's taps.
  • Promise only what worksNo role="button" with a guarded handler, and no “Tap” hint under a mouse. The plate zoom is available at every width, never enlarges past the source's own pixels, and words its hint for the pointer in use.

Components

Sections sit flat. Only what floats over content gets a shadow, and only contained cards get a radius.

DepthShadowOn
Float0 8px 24px rgba(0,0,0,0.15)Polaroid tiles, chart insets, the plan chart's mat.
Lift0 8px 32px rgba(0,0,0,0.2)Wide plates, the menu drawer.
Control0 4px 18px rgba(0,0,0,0.35)Any control on imagery: close buttons, the divider knob, the map opener.
Stage0 30px 80px rgba(0,0,0,0.5)The photograph in the lightbox.

Corners: none on buttons and section edges; 2px on mats, frames and the Captain360 cards; 14 to 16px on the destination and booking cards; fully round for icon-only controls and portraits.

The polaroid mat, carrying a chart inset

The boat section's mat: Moonstruck Navy under a hairline, wrapping the plate on three sides and deepening into a lip that carries the caption, so the caption belongs to the picture. Photographs sit square, never tilted. On the destination pages it carries a chart inset, which a photograph can replace without changing the page. This one is lifted from usvi.html and is live: drag the divider, or focus it and use the arrow keys.

Satellite view of Trunk and Cinnamon Bays
5
Chart inset18°21.2′N 64°46.2′W

Badge

A short Standout label on a square Moonstruck Navy plate: one vocabulary for the hero's line, the “Most popular” tag and the photo band's caption. Never a pill.

Captain-only catamaran chartersMost popular

Navigation

Uppercase IBM Plex Mono at 13px, tracked. The link for where you are carries a 1px hairline 8px below the label, drawn as a pseudo-element so that it stops at the last letter; text-decoration would run on under the trailing tracking. On the homepage it follows a reading line two-fifths of the way down the viewport and draws in over 0.35s; inner pages mark Destinations, their parent.

Planning pictograms

The thirteen pictograms that printed charter itineraries use, lifted as vector paths into assets/icons/tags.svg. They reach the pages as one sprite, assets/icons/tag-sprite.svg, with a named view onto each (tag-sprite.svg#snorkeling), shown as an image: one request, cached across pages, and it draws even from a page opened from disk. They are drawn in the tint at 0.7 (--text-mute), which the build writes into the sprite from the stylesheet, since an image cannot take currentColor from the page. In a log they stand alone at 24px, named by their title and an accessible label; only the legend shows names. With the On board pictograms below, they are the only icons on the site besides the button glyphs.

  • Beach chairs
  • Beach time
  • Dive / SCUBA
  • Dock available
  • Hiking
  • Island tour
  • Jumping
  • Lobster specialty
  • Notable bar
  • Paddleboarding
  • Secluded
  • Snorkeling
  • Swimming

On board pictograms

One pictogram for each kind of thing the homepage's On board lists name, in assets/icons/aboard.svg. Most are Luis Prado's, like the planning pictograms, and four are the same drawings (paddleboards, snorkel gear, diving, swim platform). Two are other designers': the inverter's plug is Richard's, and the boarding ladder is Icons Cart's pool ladder set over Luis Prado's waves. They fill with currentColor, the tint at 0.7 as the planning pictograms take it, and lead each row at 24px. They are hidden from screen readers, because the words beside them say the same. tools/listing.py matches an item to its pictogram by its words, and an item nothing matches is listed without one. tools/fetch-icons.py writes the sprite and this list.

  • Tender
  • Paddleboards
  • Floating mat
  • Snorkel gear
  • Foam noodles
  • Boarding ladder
  • Swim platform
  • Diving
  • Air compressor
  • Barbecue
  • Board games
  • Books
  • DVDs and movies
  • Generator
  • Hair dryers
  • Icemaker
  • Inverter
  • Stereo
  • TV
  • Music hookups
  • Window and door
  • Deck shower

Gauges

“How the week leans”: relative emphasis from a charter's planning sheet, on a scale ruled in quarters. These are the seven-night passage's. Each fill runs once, from the left, when the block enters view.

  • Snorkeling
  • Beach time
  • Sailing time

Calendar days

The availability grid's seven states, with the fills and inks the homepage's stylesheet gives data-cal-day. An open day that touches a booking or a hold is a turnaround day: computed, never entered, and drawn exactly as unavailable. A day a charter can start on (three nights open from it) is a button, and every other day is a plain cell. Pointing at or focusing one previews its stay of up to seven nights; choosing it lights the stay and fills the readout under the grid with the dates, the nights and one action, an email that opens with the dates in its subject and in its first lines. No price is shown there: what a week costs is the rate table's to say.

12Open
13On hold
14Booked
15Unavailable, or a turnaround day
16Past
17Previewed: a stay pointed at
18Chosen: the stay picked

The months drawn run only as far as the blocks are maintained. A date with no block reads as open, so an unmaintained month would advertise weeks nobody has checked.

Charts

The inner pages draw real nautical charts; they do not decorate with them. One asset carries the geography, and every chart on the site is a viewBox crop of that one drawing.

This is the seven-night plan chart and the first two entries of its log, lifted from itineraries.html. Point at an entry, or tab to a pin, and its leg lights while the others fall to 28%. The satellite view is the same window, in register; the passage stays plotted on both.

64°54′W64°48′W64°42′W64°36′W64°30′W64°24′W64°18′W18°42′N18°36′N18°30′N18°24′N18°18′N
Satellite view of the seven nights passage
12345678
Numbered by legNot for navigation

Drag the chart to pan

  1. Day 1
    Saturday

    Charlotte Amalie to Norman Island

    4 h under sail

    Welcome to the Virgin Islands. After everyone is aboard, we hold a short safety briefing and set sail for Norman Island: snorkeling at the Caves, then an evening at the Willy T, the floating bar in the Bight.

    • Snorkeling
    • Swimming
    • Paddleboarding
    • Jumping
    • Notable bar
    • Hiking
  2. Day 2
    Sunday

    Norman Island to The Baths, Virgin Gorda

    3 h under sail

    We head for the Baths for light swimming and a hike through the granite boulders, then on to Spanish Town for dinner ashore at CocoMaya.

    • Swimming
    • Snorkeling
    • Hiking
    • Island tour

Anatomy

PartHow it is drawn
FieldAlways Moonstruck Navy, laid with the sea plate (assets/opt/chart-sea-784.webp) at its one size, so every chart is a window onto one body of water.
Shoal halo, landassets/chart/vi-land.svg referenced twice through <use>: once as a wide faint line (Honeydew at 7%, 11px), once as the land (Honeydew fill at 16% under a 1px line). Coastline from OpenStreetMap.
FurnitureIn the label voice at chart scale: a graticule every tenth of a degree with edge labels, a four-point compass rose, a nautical-mile scale bar, a serif title block, and the line every chart carries: Not for navigation.
RoutesDashed Honeydew, one passage to a chart, drawn on once through a mask. A leg is the track a boat sails: a smooth spline through waypoints in open water, turning a corner only where the boat stops.
Pins, marksHTML, so they hold their size at any chart scale and take focus: a 24px Frosted Blue disc with a Moonstruck Navy numeral for a stop, a small ring for a place a leg passes through.
Satellite plateEvery chart carries one under a draggable divider. Open water in every plate is toned to Moonstruck Navy, so the sea is continuous across the divider and only land, reef and shallows change.
x = (lon + 65.12) × 1000        y = (18.80 − lat) × 1054.35        1 nautical mile = 17.57 units

The divider

A role="slider" whose value text names the share of satellite. Only the knob and the line take a drag, never the whole plate, because on a phone the chart already pans sideways and the page has to scroll past it. Where it rests and how high the knob rides are chosen by hand per chart, to clear its pins and labels.

InputEffect
Arrow keys2%; 10% with Shift
Page Up, Page Down10%
Home, EndSatellite only, chart only
Double-click the knobBack to rest
  • The Chart Truth RuleChart geometry is data, never drawn by eye: coastlines come from the asset, positions from coordinates, the scale bar from the projection. A pin is where the boat lies (the mooring field, not the beach or the town), and the generator's check_afloat() names any pin or track that touches land. A satellite plate is emitted only at the chart's exact viewBox, so imagery is never shown out of register.

Overlays and dialogs

Four overlays, one behavior. Each is a real dialog, and each gives the keyboard back exactly where it took it.

DialogFieldOpens with focus onAlso
Photo viewer (homepage)Moonstruck Navy at 94%CloseArrow keys and a horizontal swipe turn the photo; a counter chip; a polite “Photo 7 of 17”.
Plate zoom (homepage)Moonstruck Navy at 96%CloseClick toggles fit and enlarged; never past the source's own pixels; its hint sits on a Moonstruck Navy plate so it survives white cabinetry.
Menu drawer (every page)Moonstruck Navy, from the right, up to 20rem, over a Moonstruck Navy backdrop at 60%. The section links, an On the chart group, then Book, the same on every pageIts first linkThe burger stays on screen as the close control and is part of the focus trap. A tap on the backdrop closes it too.
Anchorage map (inner pages)Moonstruck Navy at 96%CloseDormant until a MapKit token is set. Until then the opener is a link to Apple Maps.

All four share this contract: role="dialog" and aria-modal; the element that had focus is remembered; the page stops scrolling behind; Tab wraps inside; Escape closes; focus returns to where it came from. A closed overlay is visibility: hidden as well as transparent, because pointer-events: none alone leaves its links in the tab order.

The implementations are openOverlay(), closeOverlay() and onOverlayKeys() on the homepage, and toggleMenu(), onMenuKeys(), openMap() and mapKeys() in pages.js; see the JavaScript reference.

Motion

Slow and calm. Things arrive once, over most of a second, on one soft curve, and then stay put.

--ease-reveal: cubic-bezier(0.22, 0.61, 0.36, 1)
What movesHowUnder reduced motion
Hero photographFades in once loaded, 0.6s, the shortest reveal because its length counts toward load time; none if ready for the first frame0.2s fade
Reveal (.reveal)36px rise and fade, 0.8s0.4s fade, no movement
Polaroid plates, slide-insFrom 70px or 90px to the side, 0.9 to 1s0.4s fade
Gallery stageSharpens from gray and blurred, 1.2s; it does not moveNone
A chart's routeDraws itself on through a mask, 2.6s; pins follow 0.14s apartAlready drawn
Satellite plateWipes in from the east, 1.5s, after the route has drawnAlready at rest
GaugesFill from the left, 1.2s, 0.1s apartAlready full
Nav hairlineDraws in from the left, 0.35sAppears at once
Buttons, calendar daysColor swaps, 0.2 to 0.25sUnchanged
Rate table mistA 34s driftStill
Footer weatherChanges harbor every ten seconds behind a 0.5s fade, only while the footer is on screenHolds on the first harbor

Every animation has its counterpart in the prefers-reduced-motion block at the foot of each stylesheet, and a new one needs a line there. Adding ?static to an inner page's URL resolves every entrance at once, for screenshots and print.

CSS tokens

Every custom property on :root, with its value read from the source.

The set is written twice: at the top of assets/home.css, which tools/minify.py inlines into index.html, and at the top of assets/pages.css. The two must agree, and tools/build-docs.py reports any that do not. Descriptions come from the @token tags in pages.css.

TokenValueAt 768px and belowWhat it is for
Color
--ink-page#061e45Moonstruck Navy. The page field: the reading sections, and what shows behind an overscroll.
--ink-panel#061e45Moonstruck Navy again, as the role of panels, cards, the navigation bar and photo mats, which a hairline lifts off the field.
--ink-well#061e45Moonstruck Navy again, as the role of wells, the footer, badges, and what shows behind a photograph while it loads.
--ink-page-rgb6 30 69Moonstruck Navy as channels: the wash over a photographic section, and the hero haze.
--ink-well-rgb6 30 69Moonstruck Navy as channels, for overlays and scrims (0.28 to 0.96).
--chart-navy#061e45Moonstruck Navy again, the same hex, kept as its own token because the chart and sea-section rules already read it by name.
--chart-navy-rgb6 30 69The same as channels, for the legibility halo on type set over a chart.
--cream#f1faeeHoneydew, as the role of headlines and every large figure.
--cream-bright#f1faeeHoneydew, as the role of body copy, lists and UI text. The same value as --cream.
--tint-rgb241 250 238Honeydew as channels, the tint. One hue carries every rule and every secondary voice.
--text-softrgb(241 250 238 / 0.82)The tint at 0.82. Supporting text and section leads.
--text-mutergb(241 250 238 / 0.7)The tint at 0.7. Muted small print and the tracked label voice.
--text-faintrgb(241 250 238 / 0.6)The tint at 0.6. The text floor: a booked or turnaround day in the calendar.
--line-rulergb(241 250 238 / 0.16)The tint at 0.16. Hairlines between rows, facts and notes, and the edge that lifts a panel off the field.
--line-softrgb(241 250 238 / 0.08)The tint at 0.08. The quietest edge, where a rule would otherwise read as a boundary.
--cyan#a8dadcFrosted Blue. Data and nothing else: chart pins, key numerals, open days, the focus ring.
--cyan-rgb168 218 220Frosted Blue as channels: an open day's wash, the on-hold stripe, the rate table's glow.
--cyan-muted#a8dadcFrosted Blue again: the palette has no darker blue. Text selection and gauge fills.
--action#d7283aPunch Red (see --rust). The fill of the one booking action; no other button takes a fill.
--action-ink#f1faeeHoneydew. The label on that fill: 4.62:1 (see DESIGN.md, The One Action Rule).
--mark-sea#457b9dCerulean. The sea at the foot of the mark, under its band of tint.
--btn-platergb(var(--tint-rgb) / 0.08)The plate behind a quiet action: .btn-dark, and Call and Email on a section. Honeydew at 8%, a step up from the field.
--bar-platevar(--ink-well)The plate behind the floating bar's own Call and Email. Opaque, because what is behind it is the page scrolling past rather than a field.
--rust#d7283aPunch Red, deepened so a Honeydew label on it clears 4.5:1. The one red on the site: the booking action's fill, a stale reading and the 404 lifering. 3.33:1 on the field: a wash, a border and the 24px figure, never small type.
--rust-rgb215 40 58Punch Red as channels, for that wash.
--mistrgb(69 123 157 / 0.25)The Cerulean haze inside the rate table. Homepage only.
--mist-clearrgb(69 123 157 / 0)The same color at zero alpha, so the haze's gradients fade without graying. Homepage only.
--nav-glassrgb(6 30 69 / 0.82)The plate behind the hero headline on a phone.
--nav-glass-rgb6 30 69The same as channels.
Type
--font-display'Playfair Display', 'Playfair Fallback', Georgia, serifPlayfair Display, then its metric-matched fallback. Set italic: headings, and every large figure.
--font-body'Barlow', 'Barlow Fallback', system-ui, sans-serifBarlow, then its metric-matched fallback. Everything you read: paragraphs, leads, links in prose.
--font-label'IBM Plex Mono', 'Plex Mono Fallback', ui-monospace, monospaceIBM Plex Mono, then its metric-matched fallback. The tracked uppercase label voice: navigation, buttons, captions, chart furniture, calendar days.
--type-displayclamp(3rem, 8vw, 5.75rem)Display: the homepage hero headline only.
--type-headlineclamp(2.375rem, 9vw, 3.625rem)Headline: section titles.
--type-subheadclamp(1.875rem, 7vw, 2.75rem)Subhead: a second heading inside a section.
--type-stat3.25remStat: the one figure in a view that is allowed to be loudest. On the homepage it is the rate for an ordinary week, which the two holiday rows answer a step down at Title L.
--type-title-lg2.125remTitle L: closing index headings and the homepage's wide plate names.
--type-title1.75remTitle: every card and entry heading.
--type-title-sm1.5remTitle S: small titles, and every tile title on a phone.
--type-lead1.1875remLead: the one paragraph that introduces a section, set in the body face.
--type-serif1.25remSerif text: serif running text inside a component.
--type-body1.0625remBody: Barlow 400 paragraphs.
--type-body-navy1.125remBody on navy: one step up, because light text on a dark field reads smaller. The closing paragraph; the homepage's destination blurbs.
--type-small0.875remSmall: secondary facts and credits.
--type-label0.75remLabel: the floor for tracked uppercase annotations.
--leading-serif1.5Line height for serif running text.
--leading-body1.65Line height for body copy.
--leading-title1.15Line height for titles.
--head-lead1.25emSpace over a heading that follows content in the same flow (The Heading Leads Rule).
--head-trail0.4emSpace under a heading, binding it to what it introduces.
Motion
--ease-revealcubic-bezier(0.22, 0.61, 0.36, 1)The one easing curve for entrances: soft, decelerating.
Washes
--wash-hero-top0.5The destination hero scrim's alpha at the top of the photograph, where the sky is brightest and the headline crosses it. Destination pages only.
--wash-hero-mid0.8The same scrim two-fifths of the way up, under the lede.
--wash-hero-foot0.96The same scrim at its foot, where the photograph meets the page.
--wash-drawing0.32The opacity of the layout drawing behind the homepage's layout section, solved so the lead clears 4.5:1 over its brightest line. Homepage only.
Grid and measure
--grid-cols9Columns in the page grid. Informational; the spans below are what rules use. Homepage only. home.css only
--grid-max1040pxFull width of the nine-column page grid.
--gutter32px24pxGutter between columns.
--colcalc((var(--grid-max) - 8 * var(--gutter)) / 9)One column, derived from the two above.
--span-3calc(3 * var(--col) + 2 * var(--gutter))Three columns and their two gutters. Spans 4 to 8 follow the same pattern.
--span-4calc(4 * var(--col) + 3 * var(--gutter))Four columns.
--span-5calc(5 * var(--col) + 4 * var(--gutter))Five columns: the measure for a lede.
--span-6calc(6 * var(--col) + 5 * var(--gutter))Six columns.
--span-7calc(7 * var(--col) + 6 * var(--gutter))Seven columns.
--span-8calc(8 * var(--col) + 7 * var(--gutter))Eight columns.
--measure-readvar(--span-6)Reading container (span 6).
--measure-midvar(--span-7)Mid container (span 7).
--measure-widevar(--span-8)Wide container (span 8).
--measure-fullvar(--grid-max)The whole grid (span 9).
Spacing
--section-xclamp(72px, 7.5vw, 120px)24pxHorizontal page margin. The only source of it: anything that breaks the margin computes from this. Above a phone it grows with the window, 7.5% of it, from 72px to 120px, so the column has air around it on a tablet and a laptop, not only once the grid stops growing.
--section-y56px64pxDefault vertical section padding.
--section-y-lg96px64pxEmphasis step: the homepage's availability section, and the main sections of these pages.
--section-y-xl128px80pxEmphasis step for the closing booking section.
--nav-h89px82pxHeight of the fixed nav bar: hero top padding, sticky offsets and scroll margins clear it. These pages only. pages.css only

Component properties

A few custom properties are scoped to a component. They carry a measurement from the generator or from script, never a design decision.

PropertySet byMeaning
--splitpages.jsThe chart / satellite divider's position, in percent from the left.
--knob-y, --split-delaythe generator, inlineHow high the knob rides, and how long the satellite's entrance waits for the route.
--chart-minthe generator, inlineThe width a chart keeps on a phone, where it pans.
--seathe generator, inlineWhere a chart's window falls on the one sea plate.
--ithe generator, inlineA pin's place in the entrance order.
--v, --nmthe generator, inlineA gauge's reading; one nautical mile as a share of an inset's width.
--mat, --plate-arthe stylesheets; inline per tileThe polaroid mat's width, and a plate's proportion.
--cta-vvboth scriptsHow far a phone's toolbar or keyboard has pushed the visible bottom edge up.
--link-hover, --hero-copy-rightindex.htmlThe link hover ink for a surface; where the hero headline's first line ends, for the haze.

Code reference

The source comments are the documentation. The reference pages are generated from them.

PageGenerated from
JavaScript referenceThe JSDoc in assets/home.js and assets/pages.js: every function, its parameters, the events it listens for, and the shapes of the data it handles.
CSS referenceThe doc comments in assets/home.css and assets/pages.css: every section, selector, modifier, state, script hook, custom property and breakpoint.
ARCHITECTURE.mdWritten by hand: how the site is put together, where its data comes from, and what to touch when something has to change.
DESIGN.mdWritten by hand: the reasoning behind every rule on this page.

After changing a doc comment, a token or this page, run the build and commit what it writes. tools/build-docs.py alone rewrites just docs/ and this page.

python3 tools/build.py            # the whole build, in the order that works
python3 tools/build.py --check    # writes nothing; exits 1 if anything is out of date

An internal page, marked noindex and linked only from About this site. Values here are written by tools/build-docs.py.