Skip to content
Sign inJoin waitlist

Troubleshooting — Lookis HTML

Most problems in the Lookis HTML edition come from a path with the wrong number of ../, a class the stylesheet doesn’t have yet, a copy of a section left unchanged on another page, or an empty form endpoint.

The answers below cover those first, then the questions buyers ask most.

The page looks unstyled. The browser can’t find assets/css/style.css. Pages inside a folder (portfolio/…, services/…) 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: Hero.JPG is not hero.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).

The introduction on Home stays invisible. Its words start hidden (style="opacity: 0.001; …" with data-word), and the site script shows them. If you copied the paragraph somewhere without the script, or removed data-word-appear, remove the style too. If nothing moves on any page, assets/js/main.js isn’t loading: check the <script> tags at the end of the page.

I changed something, but another page still shows the old version. The pages hold copies, not references: the footer, the testimonials, “See what I do”, the project cards, the service cards and the numbers are written into each page that shows them (Editing the site). Search the folder for the old text.

A testimonial I changed comes back as the slideshow loops. The slideshow holds three copies of the testimonials. Change all three (Editing the site). If it jumps or shows a gap after you added or removed one, set data-slider to the new number of testimonials.

The clock shows the wrong time, or nothing. It shows the time in the zone of data-clock (America/New_York in the demo), not the visitor’s. Write your zone’s IANA name there, in both copies of every page (Editing the site). An empty clock means the site script isn’t running, or the name isn’t a valid time zone.

The menu, the slideshow, the filter or the questions 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 question’s aria-controls must match its answer’s id). Open the browser’s developer tools → Console for the error, and compare the markup with the same element on an untouched page.

A Portfolio tab shows no projects, or the wrong ones. A card shows under a tab when its data-service matches the tab’s data-portfolio-tab, letter for letter (Editing the site).

Portfolio shows only four projects. 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.

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

Nothing moves: the ticker, the words, the slideshow. 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 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).

“Book a session” opens cal.com. That’s the demo’s placeholder: replace https://cal.com/ in every page with your own booking page. To send it to the Contact page instead, link contact.html and remove target="_blank" and rel from those links.

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 the clock? Yes:

  • the style guide: delete style-guide.html;
  • a page: Editing the site;
  • a section: delete its <section>…</section>, for example “Testimonials” or “See what I do”;
  • the clock: Editing the site.

Can Portfolio show every project at once? Yes: raise data-page-size on the data-portfolio box above the number of projects, and remove data-later="true" and class="hidden" from the cards. With no more cards than that, the spinner doesn’t show.

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

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 projects’ dates are written as text, so write them your way (keep the datetime as 2024-04-14). 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 clock, the phone menu, the ticker, the words, the slideshow, the filter and the loading on scroll, the questions and the form. Without it, every text and every project card still shows, but the phone menu and the questions don’t open and the slideshow stays still. 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. 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.