Skip to content
Sign inJoin waitlist

Troubleshooting — Semono HTML

Most problems in the Semono 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 (service/…, career/…, 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: Team.JPG is not team.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 title, a block or a whole section stays invisible. Most titles and blocks start hidden (style="opacity: 0.001; …" with data-reveal or data-word), and the site script shows them as they scroll into view. If you copied one somewhere without the script, or removed its data-reveal or data-word-reveal, remove the style too. If nothing appears 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 service rows, the testimonials, the figures, the closing call to action and “Latest Insights” are written into each page that shows them (Editing the site). Search the folder for the old text.

The header is transparent, with white text, all the way down Home. The section that turns it light is the one marked data-header-switch (“About Semono”). If you removed that section, put data-header-switch on the section that should take over (Pages and sections).

The header is white and hard to read at the top of a page. The page has a section marked data-header-cover, copied from Home or the 404 page: the header then lies over it in white. Keep a dark photo there, or remove the attribute.

The menu, the accordion, the tabs, the FAQ, the videos or the ticker 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 button’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 pages don’t slide when I follow a link. The page change uses the browser’s View Transitions: a browser without them, a visitor who prefers reduced motion, a link that opens in a new tab and a link to the same page all navigate normally (Making it look like your brand).

Nothing moves: the ticker, the words, the blocks. 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). Blocks and words fade in without rising, and the logo ticker stands still.

A video does not play. Nothing plays by itself: the card plays its clip when it is pressed (tapped, on a phone), muted and in a loop. If pressing does nothing, the file can’t be loaded: check data-src on the card (Editing the site), the path to your file and that it is an MP4 the browser can play. The demo’s clips come from Pexels’ servers, are not part of the download, and may move: replace them with your own.

Services, Testimonial or the Blog show only four (or six) items. That’s on purpose: more appear each time the visitor scrolls close to the spinner under the list (four at a time; the Blog six at a time on desktops). If they never do, the site script isn’t running (see above), or the spinner under the list (data-load-spinner) was deleted (Editing the site).

A new post shows on one screen size but not on another. The Blog, “Latest Insights” and “Related articles” write every card three times, once for phones, tablets and desktops (data-columns). Add the card to all three (Editing the site).

The testimonial cards overlap, or leave a gap. The grid places each card by hand: its row and column for each screen size are in the style of its <li>, and its height in row-span-[…] (Editing the site). A card whose text grows past its height overflows it: shorten the text or make the card 400 px tall (and move the cards under it).

A 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.

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

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

The Contact form offers services I don’t have. Its choices are typed in contact.html, not read from your services (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 photo band on Home (“Ready to transform your business?”). On Home, “About Semono” also tells the header when to turn light (Pages and sections);
  • a video: Editing the site.

Can the lists show every item at once? Yes: raise data-page-size on the list above the number of items, and remove class="hidden" (and data-later) from its items. With no more items 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 dates of posts and legal pages are written as text, so write them your way. The template has no language switch.

Does the site need JavaScript? For what moves and for the interactive parts: assets/js/main.js plays the titles and blocks that rise, the header, the accordion, the tabs, the FAQ, the ticker and the videos, loads more items as you scroll, and sends the forms. Without it, every title and block still shows, but the rows don’t open and the Blog shows its first cards only. 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. Two things are yours to declare: the demo’s video clips, which are fetched from Pexels when pressed (replace them), and any analytics you add. The demo’s Privacy Policy mentions cookies and analytics: edit it to match what your site does.

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.