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.
See everything first
Section titled “See everything first”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.

Colours
Section titled “Colours”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.
Text styles
Section titled “Text styles”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")}.
Breakpoints and spacing
Section titled “Breakpoints and spacing”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).
Motion
Section titled “Motion”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/ |
Reduced motion
Section titled “Reduced motion”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, shadows, spacing
Section titled “Corners, shadows, spacing”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.
Components
Section titled “Components”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:
-
Open the icon on phosphoricons.com and copy the SVG.
-
Take the
d="…"of its<path>. -
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.