Skip to content
Sign inJoin waitlist

Design — Semono HTML

Semono is styled with Tailwind CSS classes and a few colour, font and breakpoint tokens. Most changes are HTML edits; a new colour or font needs a CSS rebuild.

The pages are styled with Tailwind CSS classes written in the HTML (class="flex flex-col gap-2.5 text-soft"). assets/css/style.css contains exactly the classes the pages use, generated from src/css/style.css.

That means two kinds of change:

Change Rebuild the stylesheet?
Move, copy or delete elements; use classes that already appear somewhere in the site No
Change a colour, a font, a breakpoint; use a class that appears nowhere yet (say mt-7) Yes

Once, install the tools (needs Node.js 20 or newer):

Terminal window
npm install

Then, after a change:

Terminal window
npm run build:css # one build
npm run watch:css # rebuilds on every save while you work

Both write assets/css/style.css. The build scans the .html files in the root folder and one folder down (service/, career/, blog/, legal/), and assets/js/main.js, so a class you add there is picked up. Upload the new style.css with your pages.

In src/css/style.css:

@theme {
--color-ink: #000000; /* headings, the black buttons and cards, the footer */
--color-soft: #616161; /* body text, leads, labels, meta */
--color-grey: #ebebeb; /* hairlines, the chips, field borders, the footer's links */
--color-lime: #e4fe00; /* the accent: buttons, label dots, tags, arrow circles */
--color-green: #0f3d3a; /* text and icons on lime */
--color-background: #f7f7f7; /* the page, the form fields, the header once it is light */
--color-white: #ffffff; /* cards, white buttons, text over photos */
--color-red: #ff0000; /* the asterisk of a required field, the error label of a form's button */
--color-error-fill: rgba(255, 34, 68, 0.15); /* the button's fill after a failed send */
--color-spinner: #999999; /* the ring of the loading spinner */
}

Each name becomes a class (bg-lime, text-soft, border-grey). Change the values, rebuild, and the whole site follows: the hovers, the tabs, the plus and minus marks and the arrow circles that the script animates read the same colours (var(--color-lime), …), so they follow too.

Lime is the accent and Green the colour that sits on it, so change them as a pair. In the demo Green on Lime reads at about 10.6 : 1, but White on Lime only at 1.1 : 1: a lighter accent needs dark text and a darker one light text. Keep text on its background at 4.5 : 1 or more, so it stays readable.

Faded colours are opacity modifiers on a colour: ink/50 is the dark layer over the photos of the Home hero, the photo band and the 404 page and the placeholder text of the fields, ink/25 the veil over a video before it plays and the border of a field in use, white/20 the hairlines of the footer. They follow the palette when you change the colour.

A few colours sit outside the tokens:

Colour Where
The logo files: white (logo.svg) and black (logo-black.svg) assets/images/ (the pages draw the logo inline; these are for use elsewhere)
The sample client logos, drawn in Soft (#616161) assets/images/client-*.svg
The browser icon: a black square with a white monogram, reversed in a dark browser theme icon.svg
The swatches of the style guide repeat the hex values as text style-guide.html

The Semono wordmark, with its ™ mark, is an <svg viewBox="0 0 386 75"> drawing of three paths inside each logo link (the wordmark in two, the ™ in the third, filled with var(--logo-mark, currentColor): Lime where the logo is white, as in the original design): in the header and the footer of every page, and on the black cards (the closing call to action, the consultation card of the service pages) and beside the process on Home. It’s drawn in the current text colour: white over the Home and 404 photos, in the footer and on the black cards, black on the light header. To use your own, replace each <svg>…</svg> with your logo’s, keeping aria-hidden="true" and class="block size-full" on it and fill="currentColor" on its shapes so that it changes colour like the original. VS Code’s Replace in Files does every page at once: turn on regular expressions (.*), search for

<svg viewBox="0 0 386 75"(.|\n)*?</svg\s*>

and replace it with your <svg> on one line. Then replace aria-label="Semono" on the links with your firm’s name.

The logo is 102 × 20 px everywhere, and 93 × 18 in the header of a phone: the link carries aspect-[386/75] and w-[102px] (w-[93px] md:w-[102px] in the header). For a logo of other proportions, change the aspect ratio to your artwork’s size, and rebuild the stylesheet if the class is new.

icon.svg (the monogram on a black square; it turns white in a dark browser theme) and apple-icon.png (180 × 180 px) in the root folder are the icons in the browser tab and on a phone’s home screen. Replace the files, keeping the names.

The interface icons are inline SVG from Phosphor (and the LinkedIn mark), drawn on a 256 × 256 grid in the current text colour. To use another icon, open it on phosphoricons.com, copy its <path d="…"> and paste it in place of the old one. The arrow in the buttons is written twice: one slides out on hover as the other slides in.

Inter ships in assets/fonts/ as one variable file, inter-variable.woff2 (upright only), declared at the top of src/css/style.css:

@font-face{font-family:"Inter"; src:url("../fonts/inter-variable.woff2") format("woff2"); font-display:swap; unicode-range:…; font-weight:100 900; font-style:normal; }
:root{--font-inter:Inter,"Inter fallback: Arial",sans-serif; }

Every page uses it through font-sans on the <body>. Inter’s optical-size axis gives two looks from one file: the headings use 32 (the “Inter Display” cut) and everything else 14, written in the classes as [font-variation-settings:'opsz'_32] and [font-variation-settings:'opsz'_14]. Everything is set in weight 500, and the text typed into a form field in 400. An italic word is the browser’s slanted version of the regular font.

To use another font:

  1. Put its .woff2 files in assets/fonts/.
  2. Change the @font-face rule (font-family and src) and the first name in --font-inter. A font that isn’t variable needs one @font-face rule per weight file (400 and 500).
  3. Rebuild the stylesheet.

A font without an optical-size axis simply ignores the font-variation-settings classes. The Inter fallback: Arial rule sizes Arial like Inter while the font loads; with another font, you can delete it and its name in --font-inter. The font file covers Western European languages (the rule’s unicode-range); for other alphabets, use files that include them and remove the unicode-range. Fonts from Google Fonts can be downloaded as files with https://gwfh.mranftl.com, so they are served from your own domain, which is faster and needs no consent banner.

Text sizes are classes with a phone value first and the tablet (md:) and desktop (lg:) values after: text-[34px] md:text-[38px] lg:text-[42px]. The style guide lists every text style:

Style Phone Tablet Desktop Used for
Display 48 59 74 The Home hero’s title
H1 42 48 54 Page titles and the big figures
H2 34 38 42 Section titles, post headings
H3 28 32 36 The Contact and FAQ titles, legal headings, the title of a black card
H4 24 26 28 The quote beside a closing line, a story’s results
H5 20 22 24 Results on cards, the career sections’ titles
H6 18 19 20 Card, row, tab and accordion titles
Big 18 18 18 The hero’s lead, quotes on cards
Paragraph, menu 16 16 16 Leads, descriptions, rich text; the header’s links
Button 15 15 15 Button labels
Small 14 14 14 Labels, chips, card text
Tiny 12 12 12 Roles, the footer’s taglines and legal links

Every style has −0.03em letter spacing (−0.04em for the menu and the buttons); headings have a line height of 1.1 and the other styles 1.2.

Spacing uses Tailwind’s scale (4 px per step, so gap-5 is 20 px) or exact values in brackets (gap-[50px]). Content is at most 1400 px wide (max-w-[1400px]), with 15, 20 and 30 px at the sides, and most sections have 60 / 80 / 100 px above and below. Corners are 5 px on buttons, cards, photos, form fields and the videos, and 3 px on the grey chips (the label above a page title, the place and type of a position); dots, arrow circles, portraits and the play button are round. There are no drop shadows.

Width Prefix
Phone below 810 px (none)
Tablet 810–1199 px md:
Desktop 1200 px and up lg:

max-md: and max-lg: apply below those widths.

The style guide page: the colours and text styles, then every component with its name

style-guide.html shows the colours, the text styles, the actions (buttons and links), the logo and the icons, the navigation, the layout, the springs of the motion, the cards (service row, post, team, icon cards), the video card, the figures, the patterns (the accordion, the FAQ, the lists that load on scroll, rich text) and the forms with their button’s states, each with its name. To reuse one, copy its markup from there or from the page that shows it.

Elements with data-… attributes are wired to the site script, so keep those attributes when you copy them: data-header, data-header-cover, data-header-switch, data-hamburger, data-phone-menu, data-reveal, data-word-reveal, data-word, data-hover, data-motion, data-accordion, data-faq, data-collapse, data-tabs, data-ticker, data-video-card, data-load-list, data-load-item, data-form, data-current-year, …

The hovers, the blocks and titles that rise, the header, the accordion, the tabs, the ticker, the videos and the lists that load more are in assets/js/main.js; the page-load rise and the page change are CSS. A few settings are written in the HTML:

Effect Where
The header and the Home hero rise 60 px as the page loads (about a second) motion-safe:animate-intro with style="animation-delay: …" on each part. Arriving from another page of the site, the header doesn’t rise again.
Blocks rise 40 px as they scroll into view, once data-reveal="true" with style="opacity: 0.001; transform: translateY(40px)"; data-delay (seconds) and data-amount (the share of the block that must show). Remove both attributes to show a block at once.
Words of titles rise one after the other, 0.05 s apart data-word-reveal (Editing the site); data-stagger="0.1" on the title changes the gap
The client logos move 20 px a second, 30 / 50 / 60 px apart, and slow to a stop under the pointer data-ticker="20" and the gap-[30px] md:gap-[50px] lg:gap-[60px] classes on the ticker row
Services and Testimonial load four items at a time; the Blog six on desktops, four below data-page-size on the list (Editing the site)
Hovers on buttons, links and cards data-hover on the element, and data-motion on its parts: the rest and hover values the script moves between. data-transition="spring" or "soft" picks the spring.
The header fades between transparent and light in 0.37 s duration-[366ms] ease-spring-a in the header’s classes
The Home hero and the 404 photo are as tall as the window (90 % on phones, 85 % on tablets) h-[90vh] md:h-[85vh] lg:h-screen on their section

The springs and curves are in src/css/style.css (--ease-spring-a, -b, -e, --ease-row-hover, --ease-form, --ease-page-change) and at the top of assets/js/main.js.

On a click on a link to another page of the site, the whole screen, header and footer included, moves as one picture: the old page rises 30 % while it fades out (0.6 s), and the new one fades in from 30 % lower (0.6 s, starting 0.5 s after the first). It is the browser’s cross-document View Transitions, set by the <style> at the top of every page’s <head> (the @view-transition rule and the route-leave and route-enter keyframes). A browser without them, a visitor who prefers reduced motion, a link that opens in a new tab and a link to the same page simply navigate as they always do.

To change it, edit the durations, the delay and the 30% distances in that <style>, in every page (find and replace in files). To switch it off, delete the @view-transition { navigation: auto; } rule from every page.

With “reduce motion” switched on in the visitor’s system, movement is left out: blocks and words fade in where they stand instead of rising, the page-load rise becomes a fade, the page change swaps the pages without animation, the logo ticker and the loading spinners stand still, and the photos of the cards and the service rows change on hover without a transition. Fades and colour changes stay.