Editing the site — Fitbricks HTML
Every page of Fitbricks is a plain HTML file that you edit in a code editor. This guide shows where everything is, and how to add a program, a club, a trainer, a post or a page.
Open it
Section titled “Open it”Double-click index.html: the site opens in your browser and every link works, straight from the folder. To see it
exactly as a host serves it (and to test the forms and the 404 page), run a small local server from the folder:
npx serve .npm start runs the same command. Then edit the files in a code editor and reload the browser to see the change.
What is where
Section titled “What is where”index.html, about.html, free-trial.html, contact.htmlprogram.html Programs: every program, six at a timeclub.html Clubs: every club, six at a timetrainer.html Trainers: every trainer, six at a time (four on tablets and phones)blog.html Blog: every post, newest first, five at a time404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)program/*.html one page per program (20)program-category/*.html one page per program category (5)club/*.html one page per club (30)city/*.html one page per city: its clubs (10)trainer/*.html one page per trainer (12)blog/*.html one page per post (16)legal/*.html privacy-policy.html, terms-conditions.htmlassets/css/style.css the stylesheet (generated — see design.md)assets/js/main.js the site's scripts (you rarely need to touch it)assets/js/config.js your settings: form endpointassets/images/ photos, the logos, the category symbols, the app screens and badgesassets/fonts/ Manropeicon.svg, apple-icon.png, opengraph-image.pngsitemap.xml, robots.txtsrc/css/style.css the stylesheet's source: colours, breakpoints, the fontPages and sections describes every page, section by section.
Find the words on the page and change them in the HTML. Keep the tags and classes around them, because they carry the
layout. Ampersands are written &, apostrophes in the copy are written ' or as the typographic ’; typing '
works too. When you search for a sentence, search for a part without them.
A few texts are written more than once on purpose:
- Home’s hero title and lead rise in word by word, so each is written twice: once whole, for screen readers
(
<span class="sr-only">…</span>), and once as one<span data-word>per word. Change both. - Home’s hero quotes turn every 4 seconds. The first one is written in the HTML; all of them, with their names, are
in the
data-quotesattribute of the block, a list written as JSON (data-quotes='[{"text":"…", …}]', each quote with the member’s name). Change the attribute, and the first quote in both places. The three round photos beside them aremember-1.jpgtomember-3.jpg. - Home’s members’ stories are written three times: twice in the ticker that moves on desktops (it loops) and once in the carousel shown on tablets and phones. Search the file for a name (“Amanda R.”) to find every copy.
- Phone and desktop copies: the footer’s copyright line is written twice, one for phones and one for larger screens.
Text that repeats on every page
Section titled “Text that repeats on every page”The header, the footer, the bands, your links and your contact details are copied into many pages. Change them once for
all files with your editor’s Find in Files / Replace in Files (VS Code: Ctrl/Cmd + Shift + H). Include the
.html, .xml and .txt files:
| Replace | With |
|---|---|
https://fitbricks-html-framebrick.vercel.app |
Your domain, e.g. https://www.yourgym.com (canonical links, share cards, sitemap.xml, robots.txt) |
Waras, WARAS |
Your gym’s name (the copy of most pages, the logos’ alt="Waras", the copyright, @waras on the Instagram tiles) |
contact@warasfit.com and +1 (555) 123-4567 (shown, and in tel:+15551234567) |
Your e-mail and phone (Contact) |
500 Fitness Avenue, Los Angeles, CA 90015 |
Your main office (the CTA band and Contact) |
The e-mails, phones and addresses of each club and trainer (…@warasfit.com, +1 (555) …) |
Theirs, in each page of club/ and trainer/ |
careers@example.com, partnership@example.com, enterprise@example.com |
Your addresses (the footer’s Contact column) |
https://instagram.com/, https://facebook.com/, https://x.com/, https://youtube.com/, https://www.linkedin.com/jobs |
Your profiles and careers page (the footer, the About gallery, the trainers’ “Follow me”) |
https://www.apple.com/app-store/, https://play.google.com/store/apps?hl=en |
Your app’s store pages (Home’s app section and the footer), or delete the badges |
Your Trusted Fitness Partner |
Your tagline (the footer) |
The copyright line, © … Waras. Designed by Framebrick. |
Yours; keep the <span data-current-year>, which writes the current year |
| Fitbricks in <title> and share tags |
| Your Gym (the Home title and long titles have no suffix) |
content="Fitbricks" |
Your site’s name (application-name and og:site_name) |
The share image’s description in og:image:alt |
A description of your share image |
Review each change before replacing all: “Waras” also appears inside sentences (“At WARAS, we believe…”), in post titles and in the legal texts, which you may want to rewrite rather than replace.
Blocks that repeat on several pages
Section titled “Blocks that repeat on several pages”Some blocks are copied into several pages. Change them in every copy (find and replace in files works for text):
| Block | Pages |
|---|---|
| The header and the footer (with the first five programs under Programs, the Instagram tiles and the app badges) | Every page |
| The CTA band (“Take the first step toward a stronger you”, the main office, “Contact us”) | Home, About, Programs, every category page, Clubs, every city page, Trainers |
| The trainers band (“Our Trainers”: the first three trainers) | About, Clubs, every city page |
| The city filter (every city, then “All”) | Clubs and every city page |
| The category filter (every category but Default, then “All Class”) | Programs, every category page, and the “All Class” list of every program page |
| A card | Every list that shows its item (adding a program) |
Images
Section titled “Images”assets/images/ holds every photo. The easiest change is to replace a file with yours under the same name: every
page that shows it updates. The download ships with grey placeholders that state the size each image was designed for
(for example 1920 × 1280).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(program/…, club/…, blog/… and the others), the path starts with ../: src="../assets/images/my-photo.jpg". In
404.html it starts at the site’s root: src="/assets/images/…". The width and height on the <img> are the
photo’s own size: write your photo’s, so that the browser keeps its space while it loads.
Every photo sits in a fixed frame and is cropped to fill it (object-cover), so a photo of other proportions works, but
you lose the edges the frame cuts. Frames change shape between phone, tablet and desktop (a program photo is a card on
Programs and a wide cover on its page), so keep the subject away from the edges. Use photos at least as large as the
demo’s:
| Photos | Files | Demo size |
|---|---|---|
| A program (its cards, its cover, its share image) | program-<slug>.jpg (program-ride-cycling.jpg for Ride (Cycling)) |
1920 wide, most 1920 × 1280 |
| A club’s main photo (its cards, its page, its share image) | club-<slug>.jpg |
1200 wide, most 1200 × 800 |
| A club’s gallery | club-<slug>-1.jpg to -4.jpg |
800 wide, most 800 × 533 |
| A facility | facility-<slug>.jpg |
400 wide, most 400 × 267 |
| A trainer (cards, the page, the share image) | trainer-<slug>.jpg |
800 wide, most 800 × 1200 |
| A post’s cover (cards, the page, the share image) | post-<first words of the slug>.jpg |
1200 × 800 |
| Home: the hero, the members of the quotes, the stories | home-hero.jpg, member-1.jpg to -3.jpg, testimonial-<name>.jpg |
1920 × 1280, 160 × 160, 800 × 1200 |
| Home: memberships, coaching, the promotion | feature-clubs.jpg, feature-trainers.jpg, feature-classes.jpg, coaching-*.jpg, promo-reformer.jpg |
1200 × 1802, 800 × 1000, 800 × 1200, 600 × 900, 1200 × 800 |
| About: the facts, the reasons, the vision, the gallery | about-fact.jpg, why-*.jpg, about-vision.jpg, gallery-1.jpg to -6.jpg |
600 × 900, 600 × 900, 1200 × 800, 1200 wide |
| The CTA band, Free Trial, the 404 page | cta-background.jpg, free-trial.jpg, not-found.jpg |
1920 × 1280 |
| The footer’s Instagram tiles | instagram-1.jpg to -4.jpg |
400 × 400 |
The app screens (app-tutorials.png, app-crowd-meter.png, app-home-workouts.png, 700 × 1516, and feature-app.png)
are drawn for the template and are not placeholders; replace them with screens of your own app, or remove the app
section. The category symbols are category-<slug>.svg, white on the category’s colour (Making it look like your brand).
Use .jpg for photos and keep files small; compress them with Squoosh or
TinyPNG. Write an alt text for images that carry meaning.
Pages link to each other as about.html, club/<slug>.html, program/<slug>.html; from inside a folder, add ../
(../contact.html). Keep the .html: it’s what lets the site work from any host and from disk. 404.html is the
exception: its links start at the site’s root (/contact.html), because hosts show it at any address.
One demo program keeps parentheses in its file name, program/ride-(cycling).html, as in the original design. Use plain
letters, digits and - in the names of your own pages.
Program videos
Section titled “Program videos”Every page in program/ shows a YouTube video in its main column. The 20 videos are other creators’ videos, kept as
examples of the layout: replace them with your own before you launch. The block is a <div data-youtube>:
data-embedholds the address that plays:https://www.youtube-nocookie.com/embed/<video id>?autoplay=1&…;- the
<img>inside the button is the poster,https://i.ytimg.com/vi_webp/<video id>/sddefault.webp; data-titleand the button’saria-labelname the video.
Put your video’s id (the part after watch?v= in its YouTube address) in both addresses. Nothing loads from YouTube’s
player until the visitor presses play; the poster image does load from YouTube’s image server. To remove the video,
delete the <div data-youtube>…</div> block.
Adding a program
Section titled “Adding a program”A program is a page plus its card in the lists. The lists are written out in the HTML and keep their order, so put a new card where it belongs:
-
The page. Copy a page in
program/→program/my-program.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the cover: the photo, the name, Class Type (its category), Level, Duration and Instructor;
- the main column: the subtitle, the text, the video (program videos), Key Benefits, Program Details and the two plans (name, text, price, what’s included);
- the sidebar: “Other Programs in … Class” (the other programs of its category);
- “Other Programs” at the bottom (programs of the other categories);
- the
<head>: title, description, canonical,og:urland its photo asog:imageandtwitter:image.
-
Programs and its category. Copy a card in
program.htmland inprogram-category/<category>.html. -
The other lists that show it, if you want it there: Home’s programs (six), the footer’s Programs column (five, in every page), the “Preferred Class” choices of the free-trial form (ten), the “Popular Classes” of the clubs that offer it, the “My Fitness Programs” of the trainers who teach it, and the sidebar of the other programs of its category.
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/program/my-program.html</loc></url>
Lists that load as you scroll (Programs, Clubs, Trainers, Blog) show their first cards and hide the rest until the
visitor scrolls. Each card is an <li data-load-item>; the cards after the first page carry data-later="true" and the
class hidden (on Trainers, hidden lg:flex and hidden lg:hidden, because it shows six on desktops and four below).
These attributes belong to the place in the list, not to the card: after inserting a card, give each <li> the
data-later and class that the <li> at that place had before, and copy the last one’s for the new last card.
To remove a program, do the reverse: delete the page, its cards, any link to it and its line in sitemap.xml. Search
the folder for the file name to catch every card left behind.
Clubs, cities, trainers and posts
Section titled “Clubs, cities, trainers and posts”- A club is a page (
club/<slug>.html: its name, city and area, the main photo and gallery, About, Opening Hours, General Information with the map link, Facilities, Popular Classes, the booking form with the club’s name as the “Club Location” value, “More in”), a card on club.htmland on its city’s page, and in “More in” on the other clubs of its city. Home, Contact (“Find Your Nearest Club”) and “Other Club Location” show the first six clubs. - A city is a page (
city/<slug>.html: its name and its clubs), a chip in the city filter of Clubs and every city page, and a choice in the free-trial form’s “Preferred Location”. Each club card names its city. - Facilities are written into each club page (a photo, a name and a line); copy one within the Facilities list.
- A trainer is a page (
trainer/<slug>.html: portrait, name, title, summary, about, e-mail, phone, social links, “My Fitness Programs”, “Other Trainers”) and a card ontrainer.html; the trainers band shows the first three and “Other Trainers” the others. - A post is a page (
blog/<slug>.html: the cover, the date, the category, the title, the text, “Recent posts” — the six newest others — and “Related Articles” — the newest others of its category) and a card onblog.html, newest first; Home’s blog section shows the six newest. A post’s text is plain HTML: paragraphs, headings<h2>and<h3>and bulleted lists; copy a block of the kind you need from the page, with its classes. Its date is in the<head>too (article:published_time). A post card’s “Read more” carries the post title in a hidden<span class="sr-only">: change it with the title. - A program category is a page (
program-category/<slug>.html), a link in the category filter and the “All Class” lists, and its colour and symbol on every card of its programs.program-category/default.html(“Default Class”) has no programs and no link in the filter, as in the original design; delete it if you don’t need it.
Add each new page to sitemap.xml. A site that adds items often is easier to run with the Astro or Next.js edition,
which builds every list from one collection (Editing without touching HTML).
Legal pages
Section titled “Legal pages”legal/privacy-policy.html and legal/terms-conditions.html hold “Last Updated:” with its date, a title, a lead and
the text. Their text is a sample written for the made-up Waras gym (memberships, payments, the app, privacy@ and
support@warasfit.com), and the Terms hold a placeholder, [Your Country/State]. It is not ready to publish. Have
texts written for what your business really does (the forms, the form service you use, any analytics) and checked for
the law where you operate. The footer of every page links them.
Adding a page
Section titled “Adding a page”- Copy a page close to what you want, e.g.
about.html→pricing.html. - Replace the sections inside
<main>with the ones you want. Every section in the template is a block you can copy from its page (or fromstyle-guide.html) and paste between<main>and</main>.<main>leaves room for the header (70 px on phones, 94 px from tablets up), so the first section needs no extra space; a first section that carriesdata-header-cover(Home’s hero, a program’s cover) starts under the header instead, which stays clear over it. - Update the
<head>(title, description, canonical,og:url, and theog:andtwitter:titles and descriptions). - If you copied a page of the menu, the copy marks that page as the current one (
aria-current="page"and the black fill of its link): remove both. - Link to it from the header’s menu (it is written twice: the desktop bar and the menu that opens on tablets and phones)
or the footer’s Pages column, in every page (pages in folders write
../before each link, and404.htmlwrites its links from the root). Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the header and the footer of every page and its line from sitemap.xml. Search
the folder for the file name to catch any link left behind: buttons link to pages too (“Claim free trial” and “Start
Your Free Trial” to Free Trial, “Contact us” to Contact, “View all locations” to Clubs, “View all articles” to Blog).
The style guide
Section titled “The style guide”style-guide.html shows every component with its name, which is handy for copying a button or a card. It’s hidden from
search engines and linked from nowhere. Delete it before publishing if you don’t want it online.