Skip to content
Sign inJoin waitlist

Troubleshooting — Goeboek HTML

Most problems in Goeboek’s HTML edition come from a wrong number of ../ in a path, a class the stylesheet lacks, an unchanged copy, a slideshow 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.

The page looks unstyled. The browser can’t find assets/css/style.css. Pages inside a folder (property/…, blog/…, agent/…) 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: Property-Loft.JPG is not property-loft.jpg.

A photo is cropped in the wrong place. Every photo fills a fixed frame and loses the edges the frame cuts: about 1.5 : 1 on the cards, 16 : 9 at the top of a property page. 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 property, a post or an agent are written into each page that shows them (Editing the site). Search the folder for the old text.

A hovered property card shows another photo than its own. The card’s slideshow holds its own copies of the photos (the card photo and the first two gallery photos, then the first again): change them too (Editing the site).

Home’s slideshow skips, jumps back or shows an empty slide. data-count on the box must equal the number of slides, and the first slide must be repeated once at the end of the list; the properties’ slideshow also needs one dot per slide (Editing the site).

“Load More” shows the wrong cards, or stays when everything is shown. The first six cards of property.html must be without hidden and every later one with it (Editing the site).

A listing doesn’t show a new property. Nothing is filtered in the browser: each listing page holds its own cards. Add the card to property.html and to the pages of the property’s type, location, category and agent.

The menu, the slideshows or the phone filter 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 slideshows. The visitor’s system (yours, if you see it) has “reduce motion” switched on, and the site honours it. The slideshows also wait until they are in view.

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” (or opens its thank-you page) but nothing arrives. formEndpoint is empty, so the forms run in demo mode and only log the fields in the browser console (Forms).

After “Schedule tour” or Add property, the visitor lands on a 404. The thank-you page is addressed from the site’s root: in a sub-folder, or opened from disk, the address misses. Check data-redirect on the form against where success-scheduled.html and success-add-property.html are on your host (Publishing).

The video or the map is blank. They load from YouTube and Google Maps: check the video’s id in the <iframe>’s src, and that a privacy extension or a firewall isn’t blocking those services.

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 or a section? Yes:

  • the style guide: delete style-guide.html;
  • a page: Editing the site;
  • a section: delete its <section> in the page (Pages).

Can the filter filter in the page, without opening another page? Not as shipped: as in the original design, each choice is a link to its own listing page. A search or a filter by price needs a script of your own, or the Astro or Next.js edition with a CMS.

Can I add a dark theme? The design is light only. The colours are tokens (Design), but the translucent blacks are written on the elements (bg-ink/3, ink/5) 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-05-16). 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 slideshows, the cards’ photos, the phone filter, “Load More”, the forms and the footer’s year. Without it, every text still shows, but the menu doesn’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? The template sets no cookies of its own and the fonts are served from your own domain, but the property pages embed a YouTube video and the Contact page a Google Maps map, and those services can set cookies. Declare them, ask consent before loading them where your visitors’ law requires it, or remove the embeds. The form service you choose, and any analytics you add, are yours to declare too.

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.