Skip to content
Sign inJoin waitlist

Design — Fitbricks Astro

The look of this Astro template comes from a small set of tokens: change one and nearly every page, component and state follows.

So you rarely need to touch a component. This guide covers the colours, the logo, the font, the text styles, the spacing, the motion, the components and the icons.

Run npm run dev and open http://localhost:4321/style-guide. It shows the colours, the text styles, the icons, the eyebrows, the buttons and the header’s controls, the title sections, every card (club, program, post, feature, coaching, app, testimonial, Instagram, trainer), the accordion, the category and program links, the pricing card, the list that loads on scroll, the ticker and the carousel, the form with its states, rich text and the YouTube embed, each with its name. When you want to know what a change will affect, look there.

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

src/design-system/theme.css:

@theme {
--color-black: #000000; /* text, the dark buttons, the footer */
--color-white: #ffffff; /* the page, the header panels, light text */
--color-lime: #dbff02; /* the eyebrow pills, feature blocks, the promotion panel, list ticks */
--color-orange: #fd6934; /* the main buttons, link hovers, card actions */
--color-danger: #ff2244; /* "Something went wrong" */
--color-focus: #0099ff; /* the border of a focused form field */
--color-spinner: #999999; /* the ring of the loader under lists that load on scroll */
}

Each name becomes a Tailwind class: bg-lime, text-orange, border-focus. Swap the hex values for your own palette and the site changes. Fitbricks has two accents: Orange for actions (buttons, hovers) and Lime for highlights (the eyebrow pills, the facts and features, the promotion). Faded colours are opacity modifiers on a token: text-black/80 is body copy, bg-black/10 the card fills, bg-black/20 the rules, text-white/80 the footer’s links. They follow the palette when you change the colour.

Keep body text on its background at 4.5 : 1 or more. Black text on Lime and white text on Orange are the pairs the design uses; check them again if you change either colour.

A few colours sit outside the tokens, so change them too when you change a colour:

Colour Where
The program categories’ colours (the symbol on cards and in the filter) color of each item in src/content/collections/program-categories.json
The logo’s orange mark src/assets/images/logo-light.svg, logo-dark.svg
The browser icons public/icon.svg, public/apple-icon.png

The logo is three image files of 142 × 30, drawn by src/design-system/components/brand/Logo.astro:

File Where
src/assets/images/logo-light.svg (white wordmark, orange mark) The header over a photo (Home, Free trial, program pages, the 404), the footer, About’s photo
src/assets/images/logo-dark.svg (black wordmark, orange mark) The header on every other page, and when the header turns white on tablets and phones
src/assets/images/logo-black.svg (all black) The corner of Home’s Pilates Reformer promotion

logo in src/content/site.json names the light and dark files and the logo’s name for screen readers (alt); About and the promotion name theirs in about.json and home.json. The header shows the logo at 95 × 20 on phones, 118 × 25 on tablets and 142 × 30 on desktops; the footer at 142 × 30. To use your own, replace the files (an SVG, or a PNG twice the size shown) and keep the 142 : 30 proportions, or change the sizes in src/components/site/Header.astro.

The template ships Manrope as one variable font file, src/assets/fonts/manrope-latin-variable.woff2 (weights 200 to 800), loaded with the Astro Fonts API in astro.config.mjs:

fonts: [
{
provider: fontProviders.local(),
name: "Manrope",
cssVariable: "--font-manrope",
options: {
variants: [{ weight: "200 800", style: "normal", src: ["./src/assets/fonts/manrope-latin-variable.woff2"] }],
},
fallbacks: ["Manrope Fallback"],
optimizedFallbacks: false,
},
],

src/layouts/Layout.astro puts it in every page’s head, and “Manrope Fallback” (Arial adjusted to Manrope’s metrics, in theme.css) keeps the page from shifting while it loads. theme.css makes --font-manrope the site font (--font-sans). The template uses the weights 400 (text), 500 (labels), 600 (headings and buttons) and 800 (Home’s title).

To use another font, put its file in src/assets/fonts/ and change name and src (keep cssVariable), or use a Google font with provider: fontProviders.google() and its name (Astro downloads it when the site builds). A font that isn’t variable needs one variant per weight. Astro serves the font from your own domain either way; remove the “Manrope Fallback” @font-face from theme.css or adjust it to the new font.

src/design-system/tokens/text.ts holds the sizes, weights and line heights, named as in the original design:

Style Phone Tablet (md:) Desktop (lg:) Used for
display 38 50 64 Home’s title (weight 800, upper case)
h1 34 44 56 Page titles, big numbers
h2 32 38 48 Section titles
h3 26 30 34 Feature blocks, fact numbers, prices, level-3 headings of a post
h4 24 26 28 Form titles, level-4 headings of a post
h5 22 23 24 Card titles (clubs, programs, coaching, testimonials, app)
h6 18 19 20 Post card titles, the promotion’s note
label 12 12 12 Eyebrows, post meta (500, upper case)
button 13 13 13 Buttons, menu links, footer column titles (600, upper case)
large 18 18 18 The hero’s lead, program facts
body 16 16 16 Section texts, card texts, rich text
small 14 14 14 Quotes, card meta, footer links
caption 12 12 12 The member’s name under a hero quote

Headings are weight 600 at line height 1.2; labels and buttons are upper case with 3 % letter spacing; paragraphs are 400 at 1.4. Change the numbers in text.ts rather than in the components, and text stays consistent across the site. Use a style as class={text.h2} or combine: class={cn(text.body, "text-black/80")}.

Three sizes, set in theme.css:

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

Content is at most 1440 px wide. The side padding is 15 px on phones, 20 px on tablets and 30 px on desktops, and most sections have 60 / 80 / 100 px above and below (sectionGutters and sectionPadding in src/design-system/components/layout/section.ts). The program, club and post pages put a 350 px sidebar beside the main column on desktops; below 1200 px it follows the column. The header is fixed at the top, 70 px tall on phones and 94 px from tablets up (Pages and sections).

src/design-system/tokens/motion.ts holds the transitions, for Motion:

Token Values Used for
spring no bounce, 0.4 s The header’s panel, colours and logo; the hero’s words
springBounce bounce 0.2, 0.4 s The buttons’ arrow, the menu links’ fill, the hamburger
tween 0.4 s, ease in-out The club card’s action, the testimonial quote fading in
quoteInterval, quoteTween 4 s, 0.4 s The members’ quotes in Home’s hero turning by themselves
heroSpring, heroDelays, textDelays, textStagger 0.3–0.65 s Home’s hero appearing on load: the badge, the title word by word, the lead line by line, the buttons and quotes
appearFrom, appearSpring, appearAmount from 18 px, once half in view Home’s fact numbers and “Why Choose Us” rising into view
tickerSpeed 20 px/s The testimonial ticker on desktops (it stops while hovered)

theme.css holds the same curves as CSS for what runs without Motion (--ease-spring, --ease-spring-bounce, --ease-framer, --ease-zoom for the post card’s photo); hovers run in CSS with them. The scripts in src/design-system/scripts/ and the header’s src/components/site/header.ts read the tokens of motion.ts.

Effect Where to change it
The header hides its logo (desktop) or turns white (tablet, phone) when you scroll down over a photo src/components/site/header.ts; the pages with a photo under the header: isCoverPath in src/content/routes.ts
The members’ quotes turn every 4 s quoteInterval in tokens/motion.ts
The testimonials run as a ticker on desktops and a carousel below src/components/sections/home/TestimonialsSection.astro
Lists load more items on scroll list.pageSize in the page’s copy (Editing the content)
The FAQ’s rows open and close on their own, the first open Accordion.astro in src/design-system/components/patterns/

With “reduce motion” switched on in the visitor’s system, movement is left out: the scripts make moves, turns and size changes jump to their end (src/design-system/utils/play.ts), so the hero’s blocks and the quote photos no longer slide; the testimonial ticker stands still, and the hover movements are switched off in CSS (motion-reduce:transition-none). Fades and colour changes stay, and the quotes still change every 4 s.

Corners are 10 px on cards, panels and photos, 5 px on buttons, fields and the menu’s panels, and round on the eyebrow pills, the category symbols and the trainer’s social links. The design uses no drop shadows. Spacing is Tailwind classes on the components (gap-5, p-5, gap-[50px]); Tailwind’s scale is 4 px per step, so gap-5 is 20 px.

src/design-system/components/ holds the logo and the eyebrow, the buttons and links, the menu parts and the hamburger, the section layouts and title blocks, the cards (club, program, post, pricing, feature, info, app, testimonial, Instagram, trainer), the check list and the store badges, the forms (field, drop-down, radio group, submit button), the accordion, the carousel, the ticker, the quote slider, the list that loads on scroll, rich text, the YouTube embed and the images. Its README lists every component with its props and where it is used. The sections that make up a page are one level up, in src/components/sections/, and are listed in Pages and sections.

The arrows, the map pin, the check and the plus and minus of the FAQ are Phosphor path data in src/design-system/components/icons/paths.ts. <Icon name="arrow-right" /> (Icon.astro) draws one in the current text colour. The category symbols, the social icons of the trainer pages and the Instagram icon are SVG files in src/assets/images/.

To add an icon:

  1. Open the icon on phosphoricons.com and copy the SVG.

  2. Take the d="…" of its <path>.

  3. Add a line to iconPaths:

    bookmark: "M184,32H72A16,16,0,0,0,56,48V224a8,8,0,0,0,…",

Then use <Icon name="bookmark" class="size-5" />. Phosphor paths use a 256 × 256 grid. The style guide shows the icons in use.