Skip to content
Sign inJoin waitlist

Troubleshooting — Titen Astro

Most problems come from a content file with a typo, a missing image, or a setting that was not rebuilt into the site. The answers below cover those first, then the questions buyers ask most.

Errors you may hit

Section titled “Errors you may hit”

npm install fails, or the site behaves oddly after an update. Delete node_modules/ and package-lock.json, then npm install again. Check that node -v is 22.12 or newer.

Port 4321 is already in use. npm run dev -- --port 4322, or stop whatever holds the port.

The build stops with InvalidContentEntryDataError or a schema error. A content item lacks a field that src/content/schemas.ts requires, or a field has the wrong type (a number where text is expected). The message names the collection, the entry and the field. npm run check finds the same thing faster.

Unexpected token or “JSON parse error” in a content file. JSON allows no comments and no comma after the last entry of a list. The message gives the file and the position.

Image /images/… not found: add it to src/assets/images. The file must be in src/assets/images/ and the content must refer to it as /images/<file>: same spelling, same extension.

A project is missing from its category page, or the category tag on a project leads to “404”. The project’s category must be the slug of a category in categories.json ("residential", not "Residential").

A category page shows “404”. Category pages are built from categories.json. A slug that matches another page (about, blog, contact, …) can’t be used.

/about works on my laptop but shows “404” on the host. The pages are files (about.html). Your host needs clean URLs: see Going live.

A form says “Something went wrong”. Static mode: the endpoint answered with an error; open the browser’s console for the reason, and check PUBLIC_FORM_ENDPOINT. Server mode: the reason is in your host’s function logs. Environment variables are read when the site builds, so rebuild after changing them.

The share image or title is the old one. Facebook, LinkedIn and X cache them. Use their debuggers to refresh, and confirm that site.url is your domain.

A video does not play. The demo’s stock clips are not part of the download: the hero plays a short placeholder, and the About clip plays from the web and may move. Replace src with your own file (/videos/hero.mp4 in public/videos/) or a link to one (Editing the content). Phones only autoplay videos that are muted, which the template’s videos always are. With “reduce motion” switched on in the visitor’s system, only the poster shows: that’s on purpose.

The header is white on a page where it should be dark, or the other way round. The header is transparent with white text at the top of Home, About and the project pages, which open with a dark photo or video. The list is hasCover() in src/components/site/header-state.ts; add or remove a route there.

Questions

Section titled “Questions”

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 whole page or a video? Yes:

  • the style guide: delete src/pages/style-guide.astro and src/components/style-guide/;
  • a page: see Pages and sections;
  • the About video: delete <VideoSection … /> (and its import) from src/pages/about.astro;
  • the Home video: in src/components/sections/HomeHeroSection.astro, replace <LoopVideo … /> with a photo, <FillImage src={video.poster} priority sizes="100vw" class="object-cover" /> (imported from ../../design-system/components/media/FillImage.astro). The dark cover stays on top.

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

Do I need a CMS? No. Content is files you edit. Add one when somebody who does not use a code editor has to publish (Using a headless CMS).

Can I search posts too, not only projects? Yes: add them to the search list in src/layouts/Layout.astro (Pages and sections).

Does the site need JavaScript? The pages are plain HTML and CSS. Small scripts add the motion, the menu, the search, the slideshows and the forms; no framework runs in the browser.

Can I sell a site I build with this? Building sites for clients is what the licence is for; reselling the template itself as a template is not. The licence has the exact wording.

How do I update to a new version of the template? Download the new release and copy your src/content/, src/assets/images/, public/ and your theme.css into it. Then re-apply any component changes you made. CHANGELOG.md lists what moved.

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.