Skip to content
Sign inJoin waitlist

Troubleshooting — Balancee HTML

Most problems in Balancee’s HTML edition come from a wrong number of ../ in a path, a class the stylesheet lacks, an unchanged copy or an empty form endpoint.

The answers below cover those first (a copy is a section written into several pages, one of them left unchanged), then the questions buyers ask most.

The page looks unstyled. The browser can’t find assets/css/style.css. Pages inside a folder (service/…, portfolio/…, blog/…, legal/…) link to it as ../assets/css/style.css; a page you moved or created may have the wrong number of ../. 404.html looks unstyled when you open it from disk, and that’s expected: its paths start at the site’s root, which works on a host or with npx serve . (Going live).

An image doesn’t appear. Check the path in src against the file in assets/images/: spelling, extension, and ../ in pages inside a folder. File names are case-sensitive on most hosts even when they are not on your computer: Home-About.JPG is not home-about.jpg.

A photo is cropped in the wrong place. Every photo fills a fixed frame and loses the edges the frame cuts, and the frames change shape between phone, tablet and desktop. Choose a photo with the subject near the middle, or crop it to the frame’s shape first (Editing the site).

A class I added does nothing. assets/css/style.css only contains the classes the site already used. Rebuild it with npm run build:css (Making it look like your brand).

A video doesn’t play. The demo clips play from the Pexels CDN, so they need a connection. The hero loops by itself, the About clip plays only while it is on the screen, and the review video starts when you click “Watch a review”. With “reduce motion” switched on in the system, the first two stay on their poster. Your own clip needs muted to play by itself, a path that matches the file and a format browsers read (.mp4, H.264) (Editing the site).

I changed something, but another page still shows the old version. The pages hold copies, not references: the footer, the call to action, the service, case study and post cards, the steps and the contact form are written into each page that shows them (Editing the site). Search the folder for the old text.

The menu, the rows, the forms or the “load more” stopped working. assets/js/main.js or assets/js/config.js is missing, or an element lost a data-… attribute or an id when you edited it (a case study row’s aria-controls must match its panel’s id). Open the browser’s developer tools → Console for the error, and compare the markup with the same element on an untouched page.

The menu highlights the wrong page. The current page’s link carries aria-current="page" and the dark pill (bg-ink, with text-white); in a copied page, that mark is the original’s. Move it in both menus (Editing the site).

The Blog or the Portfolio shows only four cards. That’s on purpose: more appear each time the visitor scrolls close to the spinner under the list, four at a time. If they never do, the site script isn’t running (see above), or the spinner (data-load-spinner) was deleted.

The Blog shows more or fewer than four cards when the page opens. The first page comes from the HTML as written: the first four cards carry class="min-w-0", every card from the fifth on data-later class="hidden". Check the marks after you added or moved a card; from the first scroll on, the script counts again (Editing the site).

The clients’ logos don’t move. The loop runs from tablet width and stops when the visitor has “reduce motion” switched on or points at it; on phones the logos are a strip with two arrows instead (Editing the site).

Nothing glides: the menu, the rows, the videos. The visitor’s system (yours, if you see it) has “reduce motion” switched on, and the site honours it (Making it look like your brand).

The contact form says “Something went wrong”. The form service rejected the submission or couldn’t be reached. Check formEndpoint in assets/js/config.js, then open the developer tools → Network, submit again and read the service’s response. Web3Forms also needs formAccessKey. Some services require you to confirm your email address before the first submission goes through.

The form shows “Thank you” but nothing arrives. formEndpoint is empty, so the form is still in demo mode (the fields are logged in the browser console).

The newsletter box says “Thank you” but nothing arrives, though the contact form works. The box doesn’t read config.js: it needs an action on its own <form data-newsletter> in every page (Forms).

The newsletter box says “Try again”. The address isn’t valid, or the service refused it. Open the developer tools → Console: after a failure it logs [forms] could not send the form with the reason.

The contact form doesn’t send and a field turns red. Name, Company and Email are required and the e-mail must look like an address; the message under the field says so. Make other fields required, or optional, with required (Forms).

Clicking a link downloads a file or shows a directory listing. The link points at a folder or lacks .html. Links in this template always end in .html.

The share image or title is the old one. Facebook, LinkedIn and X cache them. Use their debuggers to refresh, and check that the og:image URL uses your domain.

Do I need Node.js or a build step? No, only to rebuild the stylesheet after changing the theme or using new classes. Everything else is editing HTML.

Can I use this template for a client? See License: that is the one place that answers it for your licence.

Can I remove the style guide, a page, a section or a video? Yes:

  • the style guide: delete style-guide.html;
  • a page: Editing the site;
  • a section: delete its <section>…</section>, for example the testimonials or a video’s box;
  • the Portfolio or the Blog: delete the page, its menu links and its sitemap line, and the buttons that lead to it (“See all blog”, “View all case studies”, the case study and post cards on Home).

Can I change the fonts to my brand’s? Yes: Making it look like your brand.

Can the “Let’s talk” button open my calendar? Yes: it already leads to https://cal.com/; replace that address with your Cal.com or Calendly page, or with contact.html (Editing the site).

Can I write the site in another language? Yes: write the text in your language and set lang="en" on each page’s <html> and og:locale (en_US) in its <head>. The posts’ dates are written as text, so write them your way (keep the datetime as 2024-01-02). The template has no language switch.

Does the site need JavaScript? For what moves and for the interactive parts: assets/js/main.js runs the phone menu, the case study rows, the forms, the loading of more cards, the logo ticker’s arrows, the videos and the footer’s year. Without it, every text and every card still shows, but the phone menu and the rows don’t open, the videos don’t play and the forms can’t send. Every word and link is in the HTML, so search engines read the whole site.

Does the site need a cookie banner? As shipped, the template sets no cookies and loads no third-party scripts: the font is served from your own domain. The demo videos come from the Pexels CDN until you replace them. Any analytics you add is yours to declare.

Can I use it with WordPress, Webflow or a site builder? Not directly: it is plain HTML and CSS. You can paste sections into a builder that accepts custom HTML, but the interactions rely on assets/js/main.js.

Can I connect a CMS? See Editing without touching HTML for the options, including the Astro and Next.js editions built for one.

How do I update to a new version of the template? CHANGELOG.md in the new release lists what changed. For a script or style fix, replacing assets/js/main.js and assets/css/style.css is usually enough (run npm run build:css again if you added classes of your own or changed the theme). Page changes are listed so you can apply them to your edited pages.

Can you customise it for me, or build my site? Yes. Marcframe, the studio behind this template, updates templates to your needs (brand, content, new pages and features), builds custom templates and designs new websites. Get in touch at marcframe.com/contact or hire us on Contra.

Something is broken and none of this helps. Support and updates: https://framebrick.co/support. Send the page, the browser, and the error text or a screenshot: it makes the answer much faster.