Skip to content
Sign inJoin waitlist

Troubleshooting — Compose Digi HTML

Most problems in Compose Digi’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 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 (services/…, projects/…, careers/…, 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 . (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: About-1.JPG is not about-1.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).

I changed something, but another page still shows the old version. The pages hold copies, not references: the header, the footer, the service names, the project, post and job cards, the page headers’ social buttons and the client quotes are written into each page that shows them (Editing the site). Search the folder for the old text.

A ticker still shows an old name or logo now and then. Each ticker writes its items three times; you changed one copy (Editing the site).

The plan switch or the testimonial slider shows the old text. After the first press, they read their texts from the data-plans and data-testimonials attributes, not from the HTML: change them there (Editing the site). If the switch or the slider stops working, the list is no longer valid: an apostrophe or a double quote in a text broke it (write them ' and \").

The menu, the service list, the switch, the slider or 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 service 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.

Two service rows are open on Home, or none. The page opens with the rows as written: exactly one row should say aria-expanded="true" with its panel open (Editing the site).

Load More shows the wrong cards, or stays after the last one. The first page comes from the classes written on each card; check them after you added or moved a card (Editing the site).

The footer’s “Tell Us Your New Ideas” is too big or too small after I changed it. Its size is set to fit those exact words: change md:text-[8.532cqw] and rebuild the stylesheet (Editing the site).

The custom cursor doesn’t show. It shows only with a mouse, over the page’s <main>, and not on Contact, a post’s article or the 404 page (Making it look like your brand).

Nothing moves: the tickers, the scroll effects. 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 video doesn’t play. It plays from YouTube when the visitor presses Play, so it needs a connection, and the id in data-embed must be a public video that allows embedding (Editing the site).

One project page answers “not found” on my host. Its file name has an accented letter (home-décor), which some upload tools change; rename it without the accent and update its links (Going live).

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

The form doesn’t send and a field turns red. The first name, the last name and the e-mail 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 the video? Yes:

  • the style guide: delete style-guide.html;
  • a page: Editing the site;
  • a section: delete its <section>…</section> (and the divider beside it), for example the testimonials or the video;
  • the Careers or Blog page: delete it, its pages, its links (the footer, the menu, “See all positions” and “Open Positions” on About, the Home blog section) and its sitemap lines.

Can I show prices in another currency, or hide them? Yes: the prices are text, written in the plan card and in its data-plans (Editing the site). To hide them, delete the plan card on every service page.

Can visitors book a call in my calendar? “Book a call” and the footer’s “Book a Call” open https://cal.com/: point them at your own Cal.com or Calendly page. The contact form sends a message; it doesn’t book a time.

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 posts’ dates are written as text, so write them your way (keep the datetime as 2024-06-25). 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 header and the phone menu, the cursor, the tickers, the service list, the switch, the chart, the slider, the video, Load More, the scroll effects and the form. Without it, every text and photo still shows, but the phone menu and the service rows don’t open, the plans stay weekly, the tickers and the chart stay still, only the first page of cards shows, the video doesn’t open and the form 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 fonts are served from your own domain. The About video loads from YouTube, which may set cookies, only when a visitor presses Play. 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.