Editing the site — Balancee HTML
Every page of Balancee’s HTML edition is a plain file you edit in a code editor: where everything is, and how to add a service, a case study, 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 form 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, contact.htmlservice.html the Services page (every service as a card, "From insight to execution", the contact form)portfolio.html the Portfolio page (every case study as a card, four at a time)blog.html the Blog page (every post as a card, four at a time)404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)service/*.html one page per service (8)portfolio/*.html one page per case study (8)blog/*.html one page per post (9)legal/*.html Terms of Service, Privacy Policyassets/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, portraits, client logos, the LinkedIn icon, the wordmark as filesassets/fonts/ Intericon-light.svg, icon-dark.svg, apple-icon.png, opengraph-image.pngsitemap.xml, robots.txtsrc/css/style.css the stylesheet's source: colours, breakpoints, font, animationsPages 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. A heading looks like this:
<h2 class="text-[30px] md:text-[36px] lg:text-[48px] leading-[1.2] font-medium text-ink"> Real results. Clear impact.</h2>Change the words, leave the class. Long lines are wrapped onto several lines in the files, so when you search for a
sentence, search for a few words of it. Ampersands are written & (Innovation & growth), some apostrophes
' (We'd love to hear from you) and quotation marks "; the demo also uses the typographic ’
(Let’s talk). Typing ' and " in text works too; & should stay &.
Button labels (not the header’s links) are written three times: once to size the element (class="opacity-0", the copy
screen readers read) and twice in the copy that rolls up on hover (aria-hidden="true"). Change all three:
<span class="opacity-0">Contact us</span><span aria-hidden="true" …><span>Contact us</span><span>Contact us</span></span>Text that repeats on every page
Section titled “Text that repeats on every page”The header, the footer, your links and your contact details are copied into every page. Change them once for all files
with your editor’s Find in Files / Replace in Files (VS Code: Ctrl/Cmd + Shift + H):
| Replace | With |
|---|---|
https://balancee-html-framebrick.vercel.app |
Your domain, e.g. https://www.yourfirm.com (canonical links, share cards, sitemap.xml, robots.txt) |
hello@example.com |
Your e-mail: the footer of every page and the Contact page |
+44 20 7946 0345 and tel:+442079460345 |
Your phone, as shown and as dialled (the footer and the Contact page) |
https://cal.com/ |
Your booking page: “Let’s talk”, “Book a Free Consultation” (33 of the 35 files). Or point them at contact.html |
https://linkedin.com, https://instagram.com, https://facebook.com, https://x.com |
Your profiles: the footer’s “Social” column (with the link texts Linkedin, Instagram, Facebook, Twitter), About and Contact. Remove the <li> of a network you don’t use |
Never Miss an Update — Subscribe! |
The footer’s newsletter title |
Balancee. All rights reserved. |
Your footer note; keep the <span data-current-year> before it for the year |
aria-label="Balancee" |
Your name: the name of the logo links (header and footer) for screen readers |
| Balancee in <title> and share tags |
| Your Name (the Home title, Balancee - Business and Consulting Website, has no suffix) |
content="Balancee" |
Your site’s name (application-name and og:site_name) |
Balancee - business and consulting website template |
A description of your share image (og:image:alt, twitter:image:alt) |
The address and the opening hours (“Brooklyn, New York 123 Wythe Avenue…”, “Monday – Friday”, “9:00 AM – 6:00 PM (EST)”)
are only on contact.html. The team cards on About link to https://www.linkedin.com/ and the awards to
https://www.awwwards.com/: write each person’s profile and each award’s page.
Include the .html, .xml and .txt files. Review each change before replacing all: “Balancee” also appears in the
copy (the About text, the Home “About Balancee” label, the testimonials), which you may want to rewrite rather than
replace. The year in the footer updates itself (data-current-year).
Sections that repeat on several pages
Section titled “Sections that repeat on several pages”Some sections are copied into several pages. Change them in every copy (find and replace in files works for text):
| Section | Pages |
|---|---|
| Header and footer (with the newsletter box, the case studies and services it lists) | Every page |
The call to action band (“Ready to move your business forward?”, “Get in Touch”, “Book a Free Consultation”, the office photo cta-office.jpg) |
Every page except Services, Contact and style-guide.html: Home, About, Portfolio, Blog, each service, case study and post, the legal pages and the 404 |
| “From insight to execution” (the four steps) | index.html (with the photo home-process.jpg), service.html |
| The contact form | contact.html, service.html (Forms) |
| The post cards | index.html (the newest three), blog.html (all nine), “Other blogs” on every page in blog/ |
| The service cards | index.html (the first six), service.html (all eight), “Other services” on every page in service/ |
| The case study cards | index.html (two cards and four rows), portfolio.html (all eight), “Other case studies” on every page in portfolio/ |
The Home hero
Section titled “The Home hero”- The title (“We help businesses find clarity and grow with purpose.”), the lead, the two buttons (“Let’s talk” to Contact, “Our services” to Services) and the caption are plain text.
- The rating (“4.9 /5.0”, “Average rating from 40+ global clients”) sits beside three client photos (
avatar-1.jpgtoavatar-3.jpg) and five stars (read by screen readers as one image,aria-label="Rated 4.9 out of 5": change it with the rating). They are plain text; nothing counts up. - The wordmark over the video is the text “Balancee” (Making it look like your brand).
- The video loops muted behind it (the videos).
The clients ticker
Section titled “The clients ticker”“Trusted by clients across the world” shows six logos, client-logo-1.svg to client-logo-6.svg (each with an alt):
on tablets and desktops they run in a slow loop that pauses when you point at it; on phones they show in a strip with
two arrows (data-logo-slides data-count="6", the arrows carry data-logo-step="-1" and "1"). Replace the files with
your clients’ logos, keeping the names; to change their number, change data-count to the new number and add or delete
a logo in both versions (the running one, where the six logos are written three times in a row so that the loop has no gap, and the strip).
The services
Section titled “The services”Home shows the first six services as cards and Services all eight; each links to its page in service/.
- To change a service, change its card in
index.htmlandservice.html, its page, and its name in the two contact forms’ choices (Forms). - A service page has the title and a short intro, the “What we offer” tags, “What we do” with a photo, “Services Offered” (six items), “How we work” (four steps with a photo), “Other services” (the first three other services) and the call to action.
The case studies
Section titled “The case studies”Portfolio shows all eight case studies as cards, four at a time as you scroll (the lists);
each links to its page in portfolio/.
- On Home, “Real results. Clear impact.” shows two cards (Retail Revive and Health Streamline) and, under “Recent
case studies”, four rows (Tech Innovate, Finance Rebound, Global Expand and Eco Strive). Each row is a
<div data-case-row>whose header opens and closes it; the first row starts open. A row’s panel has anid(home-case-0…) that the button’saria-controlsrepeats: keep them matching when you copy a row. The numbers(001)… are text. - A case study page has the title and summary, the client, budget, duration and team size, an overview (a wide photo
and three more), “Client Challenges” (two photos), “Solutions”, “Results” (a photo and three figures such as
+37%), “Other case studies” (the first two others) and the call to action.
The testimonials
Section titled “The testimonials”“What our clients say” shows three quotes (Louis Tremblay, Maya Chen and Kareem Alvi) with their roles, their figures
(+20% “Team Engagement”) and, for two of them, a portrait (client-maya-chen.jpg, client-kareem-alvi.jpg), beside a
review video that plays on click (“Watch a review”) and a photo (home-cta.jpg). The quotes are text in the page.
The team, the timeline and the awards
Section titled “The team, the timeline and the awards”About shows “Your partner for growth and transformation” (three paragraphs and four photos, about-who-1.jpg to
about-who-4.jpg), “From local beginnings to global impact” (six milestones with their years, and the three awards)
and “Driven by expertise, united by purpose” (six team cards: photo, name, role, a short bio and a LinkedIn link). All of
it is text and links in about.html. A team photo is team-<name>.jpg.
The figures
Section titled “The figures”The facts on Home (“$86M+” Revenue Impact), About (“320+” Projects completed, “120+” Global clients) and in each case
study’s results (+37%) are plain text: they don’t count up. Change them in place.
The blog and Portfolio lists
Section titled “The blog and Portfolio lists”The Blog page shows four posts, then four more each time the spinner under the list comes within about 500 px of the screen; Portfolio does the same with its case studies. Every card is in the HTML, so search engines find them all; visitors without JavaScript see them all too.
<div data-load-on-scroll data-page-size="4" class="relative w-full">…<div data-load-item class="min-w-0">…</div><div data-load-item data-later class="hidden">…</div>- From the fifth card on, cards carry
data-later class="hidden"(the first fourclass="min-w-0"). The list keeps the order of the HTML: the newest post first. data-page-size="4"sets how many show at a time.
The videos
Section titled “The videos”Home has three videos, all from Pexels and played from their servers; they are not in the download:
| Where | Mode | src |
|---|---|---|
| The hero, behind the wordmark | data-mode="loop": muted, loops, plays as soon as the page opens |
https://videos.pexels.com/video-files/5716913/5716913-hd_1280_720_25fps.mp4 |
| “A consulting partner built for modern business” | data-mode="view": plays while it is on screen, pauses when it leaves |
https://videos.pexels.com/video-files/3249675/3249675-sd_960_540_25fps.mp4 |
| “Watch a review” in the testimonials | data-mode="click": plays and pauses when the button or the video is clicked |
https://videos.pexels.com/video-files/5716897/5716897-hd_1280_720_25fps.mp4 |
<div data-video-player data-mode="loop" …> <img src="assets/images/home-hero-poster.png" … /> <video data-video src="https://videos.pexels.com/…" muted loop playsinline preload="auto" aria-hidden="true" …></video></div>Replace each src with your own clip: a file in your folder (assets/videos/intro.mp4, a few MB, in .mp4) or the
address of a video host. The clip fills its frame and is cropped to it, so use a landscape (16 : 9) video. Keep muted
(browsers don’t play a video with sound by itself). The picture before the video plays is the poster, an <img>
in the same box (home-hero-poster.png, home-about-video-poster.png, home-review-poster.jpg): replace it with a
frame of your video. With “reduce motion” switched on, the looping and the on-screen videos stay on their poster. To
remove a video, delete its <div data-video-player> and give the frame a photo.
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 2400 × 1600).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(service/…, portfolio/…, blog/…, legal/…), 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, so keep the subject away from
the edges. Use photos at least as large as the demo’s:
| Photos | Files | Demo size |
|---|---|---|
| The call to action’s photo, on every page | cta-office.jpg |
2400 × 1600 |
| The Home hero’s poster and the About clip’s poster | home-hero-poster.png, home-about-video-poster.png |
1920 × 1080, 1280 × 720 |
| The review video’s poster | home-review-poster.jpg |
1506 × 1004 |
| Home “About” photo, “How we work” photo, the testimonials’ photo | home-about.jpg, home-process.jpg, home-cta.jpg |
1040 × 1558, 934 × 1401, 734 × 918 |
| Client avatars beside the rating (round) | avatar-1.jpg to avatar-3.jpg |
120 × 120 |
| A client’s portrait in a testimonial | client-maya-chen.jpg, client-kareem-alvi.jpg |
120 × 120 |
| The photos at the top of About | about-hero-1.jpg, about-hero-2.jpg |
510 × 287, 934 × 623 |
| “Your partner for growth and transformation” | about-who-1.jpg to about-who-4.jpg |
1120 × 1493, 1120 × 747, 346 × 519, 734 × 918 |
| A team member | team-<name>.jpg |
about 714 wide, 893 to 1071 tall |
| A service: the card and the page’s top photo, “What we do”, “How we work” | service-<slug>.jpg, service-<slug>-what-we-do.jpg, service-<slug>-process.jpg |
1034 wide, 1090 × 727, 934 × 668 |
| A case study: the cover (also its card) | portfolio-<slug>-cover.jpg |
2400 wide |
| A case study’s overview (one wide, three small), challenges (two), solutions and results | portfolio-<slug>-overview-1.jpg to -4.jpg, -challenges-1.jpg, -challenges-2.jpg, -solutions.jpg, -results.jpg |
1900 × 1267 and 620 × 410; 940 wide; 1900 wide |
| A post’s cover (its card and the large photo of its page) | post-<slug>.jpg |
2000 wide |
| The author’s photo (the demo reuses the team photos) | team-<name>.jpg |
about 714 wide, 893 to 1071 tall |
Sizes are those of the placeholders and vary a little from one item to the next; keep your photos at least as large.
Several files are used in more than one place: a service’s and a case study’s photos (cards, their page and, for a cover,
the Home page), a post’s cover, cta-office.jpg and the avatars. Replacing such a file changes every place; to show
another photo in one of them, use a new file there.
Use .jpg for photos and keep files small; compress them with Squoosh or
TinyPNG. Write an alt text for every photo that carries meaning (the demo describes each one);
leave it empty (alt="") for decorative ones.
The six client logos (client-logo-1.svg …) and icon-linkedin.svg are drawings, not placeholders; logo.svg and
logo-white.svg are the wordmark as files for use elsewhere (the pages write it as text); favicon.png,
favicon-dark.png and og-image.png are extra copies of the icons and the share image that no page uses.
Pages link to each other as about.html, blog.html, blog/<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.
The social links in the footer lead to the networks’ home pages until you change them. mailto: and tel: links open
the visitor’s mail app or phone.
Adding a service
Section titled “Adding a service”-
The page. Copy
service/business-strategy.html→service/my-service.html(lower-case words joined by-). Edit the title and intro, the tags, the three sections’ texts and photos, and the<head>(title, description, canonical,og:url,og:andtwitter:titles and descriptions). -
The cards. Add a card to
service.html; to show it on Home, replace one of the six there. -
The footer. The footer lists the first four services in a row: edit it in every page (find and replace in files) if the new service should be among them.
-
The contact form. Add a choice to the “I’m interested in …” radios on
contact.htmlandservice.html(Forms). -
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/service/my-service.html</loc></url>
“Other services” on the service pages shows the first three other services of the list, so write it by hand on each page. To remove a service, do the reverse and search the folder for its file name.
Adding a case study
Section titled “Adding a case study”- The page. Copy
portfolio/retail-revive.html→portfolio/my-project.html. Edit the name, headline and summary, the client, budget, duration and team facts, the four sections’ texts, photos and figures, and the<head>. - Portfolio. Copy a card (
<div data-load-item …>) inportfolio.htmland edit its link, photo and texts. Keepclass="min-w-0"on the first four cards anddata-later class="hidden"on every card after them (the lists). - Home and the footer, if it should be among the six case studies shown on Home or among the first five in the footer’s “Case Study” column (every page).
- Other case studies on the pages where it should appear.
- The sitemap: add its line to
sitemap.xml.
Adding a post
Section titled “Adding a post”-
The page. Copy an existing one, e.g.
blog/the-power-of-emotional-intelligence-in-leadership.html→blog/finding-your-calm.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the title (
<h1>) and the excerpt under it, the author’s name, role and photo, the category chip and the date (the<time>element’sdatetime,2024-01-02, and its text,Jan 2, 2024); - the cover photo (
srcandalt); - the text: paragraphs
<p class="mt-5 first:mt-0">, headings<h2 class="… mt-10 … first:mt-0">, lists<ul class="mt-5 first:mt-0">or<ol …>, and<strong>for bold (copy them from the post); - “Other blogs”: up to two other posts of the same category, newest first (leave it out when there is none);
- the
<head>: title, description, canonical,og:url, theog:andtwitter:titles and descriptions, the share image (og:image,twitter:image: the cover’s full address),og:image:alt,article:published_time(the date),article:authorandarticle:section(the category).
- the title (
-
Blog. Copy a card (
<div data-load-item …>…</div>) inblog.html, paste it at the top, and edit its link, photo, category, date and title. Keepclass="min-w-0"on the first four cards anddata-later class="hidden"on every card after them. -
Home, if it should be among the three cards of “Insights that drive better business” (they are the newest three: drop the last one).
-
Other blogs on the other posts of the same category, where it should appear.
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/blog/finding-your-calm.html</loc></url>
To remove a post, 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 any link left behind.
The legal pages
Section titled “The legal pages”legal/terms-of-service.html and legal/privacy-policy.html hold sample texts with placeholders ([Your Company Name], [URL] and others) and “Last updated:” with its date (<time datetime="2025-08-10">). Write your own terms, or
have them checked: the samples are a starting point, not legal advice. Their text uses the same tags as a post:
<h2>, <p>, <ul>, <ol>, <li> and <strong>.
Adding a page
Section titled “Adding a page”- Copy a page close to what you want, e.g.
about.html→approach.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>. Keep the call to action band (the last<section>) if you want it. - Update the
<head>(title, description, canonical,og:url, and theog:andtwitter:titles and descriptions). - If you copied a page that is in the menu, the copy marks that page as the current one: in the header’s two menus (the
one for tablets and desktops,
aria-label="Main", and the one for phones,aria-label="Mobile"), the link of the current page carriesaria-current="page"and the filled look (bg-inkwithtext-white); the others saybg-transparentandtext-text group-hover:text-ink. Give the old link the plain look and remove itsaria-current. - Link to it: in the two menus, copy the
<a>of a neighbouring link and change itshrefand its text; or add it to the footer’s “Quick links”. Keepdata-close-menuon the phone links: it closes the menu when the link is pressed. The header and the footer are the same in every page of a folder apart from the current-page marks, so once one page is done, copy them into the others (pages inservice/,portfolio/,blog/andlegal/write../before each link, and404.htmlwrites its links from the root,/approach.html). Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the menus 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 (“Our services” and “View all
services” to Services, “More about us” to About, “See all blog” to Blog, “View all case studies” to Portfolio, “Let’s
talk” in the hero, “Get in Touch”, “Get started now” and “Get in touch now” to Contact).
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; its sample forms never
send anything.