Troubleshooting — Brickfolio HTML
Most problems in Brickfolio’s HTML edition come from a wrong number of ../ in a path, a class the stylesheet lacks, an unchanged copy, a ticker count that no longer matches or an empty form endpoint.
The answers below cover those first (a copy is a block written into several pages, one of them left unchanged), then the questions buyers ask most.
Problems you may hit
Section titled “Problems you may hit”The page looks unstyled.
The browser can’t find assets/css/style.css. Pages inside a folder (project/…, blog/…) 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 . (Publishing).
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: Project-Cover.JPG is not
project-cover.jpg.
A photo is cropped in the wrong place. Every photo fills a fixed frame and loses the edges the frame cuts: 3 : 2 on a project or post page, a fixed height on the cards. 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
(Design).
I changed something, but another page still shows the old version. The pages hold copies, not references: the header, the footer and every card of a project or a post are written into each page that shows them (Editing the site). Search the folder for the old text.
A testimonial or a logo I changed still shows the old one from time to time.
The tickers write their list twice: change the copy with aria-hidden="true" too, and set data-count on the box to
the number of items (Editing the site).
The roles under the name jump, or show an old one.
They are written three times: the screen-reader line, one <li> per role, and the first role again at the end. Keep
them in step and data-count equal to the number of roles.
A header link doesn’t scroll to its section.
The link’s href (index.html#project) must match the section’s id (id="project") in index.html, in every page.
“More Projects” or “More Posts” shows the wrong cards, or stays when everything is shown.
The first four cards must be without the class hidden and every later one with it; with four cards or fewer, delete
the button (Editing the site).
The profile card stops sticking before the end of Home.
You added or removed a block of Home’s column: change lg:row-span-11 on the profile card’s block to the number of
blocks beside it, and rebuild the stylesheet if the new class is not in it (Pages).
The menu, the tickers or the questions stopped working.
assets/js/main.js didn’t load (check its path, ../ in folders), or a copied block lost its data-… attributes:
copy it again from the page or from style-guide.html. The browser’s console (F12) says what failed.
Nothing moves: the tickers, the roles. The visitor’s system (yours, if you see it) has “reduce motion” switched on, and the site honours it.
A form says “Something went wrong”.
The service refused the request: check formEndpoint in assets/js/config.js (open the URL in a browser tab), confirm
the form at the service if it asks you to (Formspree does, once), and for Web3Forms set formAccessKey. Opened straight
from disk, the browser may refuse to send: test on your host or with npx serve ..
A form says “Thank you” but nothing arrives.
formEndpoint is empty, so the forms run in demo mode and only log the fields in the browser console
(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.
Questions
Section titled “Questions”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 or a section? Yes:
- the style guide: delete
style-guide.html; - a page: Editing the site;
- a section of Home: delete its
<section>inindex.html(Pages).
Can I add a light theme?
The design is dark only. The colours are tokens (Design), but the translucent whites are
written on the elements (text-white/80, bg-white/10) and would need a second set.
Can I change the fonts to my brand’s? Yes: Design.
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 dates are written as text, so write them your way (keep the datetime as 2024-07-08). The font files
hold Latin letters only (English and most Western European languages); for other alphabets, add the matching Inter files
(Design). 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 roles, the tickers, the
service cards, the social links, the questions, “More Projects” / “More Posts” and the two forms. Without it, every text
still shows, but the menu and the questions don’t open, the later cards stay hidden and the forms can’t send. Every card
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 fonts are served from your own domain. The form service you choose, and any analytics you add, are 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.