Skip to content
Sign inJoin waitlist

Troubleshooting — Fitbricks Next.js

Most problems with this Next.js template come from a content typo, a missing image or a form variable not set on the host. Those answers come first.

Then come the questions buyers ask most.

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 20.9 or newer.

Port 3000 is already in use. npm run dev -- -p 3001, or stop whatever holds the port.

npm run dev or npm run build stops with “Failed to fetch font Manrope”. The font is downloaded from Google Fonts when the site builds (and the first time the development server runs), and the message ends with “Please check your network connection”. Connect, check your proxy or firewall, and run it again. To build without that download, host the font yourself with next/font/local (Making it look like your brand).

Module not found: Can't resolve '@/content/…' The path or the file name is wrong. @/ means src/, so @/content/site is src/content/site.ts. File names are case-sensitive on the servers that build your site, even when they are not on your laptop.

Property 'x' is missing in type … or Type '"…"' is not assignable to type 'Level' A content item lacks a field that src/content/types.ts requires, or names a value that doesn’t exist (a program’s level must be "easy", "medium" or "hard"). Your editor names the file and the line.

Cannot find name 'PageProps' (or 'LayoutProps') from npx tsc --noEmit. Next.js generates those types into .next/. Run npm run dev or npm run build once (or npx next typegen), then check again.

An image does not appear. The file must be in public/images/ and the content must refer to it as /images/<file>: same spelling, same extension, no public in the path.

A photo is cropped in the wrong place. Every photo sits in a frame and is cropped to fill it from the centre, and the frames change shape between phone, tablet and desktop (a program’s photo is a full-width cover on its page and a card elsewhere). Keep the subject in the middle (Editing the content).

The build fails but npm run dev was fine. The build is stricter: it checks the types and renders every page. Read the first error, not the last; it names the file.

A form says “Something went wrong”. A required field is empty, the provider rejected the request, or a variable is missing. The reason is in your host’s function logs (Vercel: the deployment’s Logs tab), after [forms] Get in Touch could not be delivered (or “Claim Free Trial”, “Book Your Class Now”). Check that the environment variables are set for the environment you deployed to, that FORM_PROVIDER names a provider that exists, and redeploy after adding them. Mailchimp refuses addresses it considers fake or that unsubscribed before.

A form says “Thank you” but nothing arrives. With FORM_PROVIDER=console (the default, also when the variable is missing) submissions are only written to the server log: set a provider (Forms). If you added a field named fax, rename it: that name is the hidden spam trap, and a submission that fills it is dropped.

A form won’t send. The e-mail is required on every form, and the contact time on the contact and free-trial forms (“Anytime” is only its prompt: choose Morning, Afternoon, Evening or Night). Change this in the form’s fields (Forms).

A new post doesn’t show first. Posts are sorted by date, newest first: check the new post’s date ("2025-08-18", year first).

A new program or club doesn’t show on Home. Home shows the first six programs and the first six clubs of their files (Editing the content). Move the item up, or change count in src/content/pages/home.ts.

A program or club shows a slug instead of its category or city. Its category or city names a slug that no item has. Fix the spelling, or add the category or city.

A club or trainer page misses a class or a facility. Its programs or facilities lists a slug that no item has; it is skipped. Check the spelling against programs.ts and facilities.ts.

A post has no “Related Articles”. No other post has exactly the same category text. The section is left out when it would be empty.

Programs, Clubs, Trainers or Blog show only a few items. They load more each time the end of the list comes into view; scroll down. Visitors without JavaScript see them all. Change the step in list.pageSize of the page’s copy.

The video of a program doesn’t play, or shows nothing. video must be a YouTube link (watch?v=, youtu.be/ or embed/) of a video its owner allows to be embedded. Without a valid link the video block is left out.

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.

The ticker doesn’t move, or the hero’s text doesn’t rise. 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).

An AGENTS.md or a CLAUDE.md appeared in the project. Next.js 16.4 adds them when npm run dev runs next to an AI coding assistant (Install and run). Keep or delete them; the site doesn’t use them.

Can I use this template for a client? See License: that is the one place that answers it for your licence.

Who is Waras? Nobody: a made-up gym that fills the demo. Its name, logo, e-mails, phone numbers and addresses are not real and must be replaced with yours (Editing the content).

Can I keep the program videos? No. They are other creators’ videos on YouTube, kept as examples. Put your own in each program’s video before launch (Editing the content).

Are the legal pages ready to use? No. The Privacy Policy and the Terms & Conditions are samples for the demo gym, with a placeholder ([Your Country/State]). Have them written for your business and country before you publish (Editing the content).

What about the App Store and Google Play badges? They link to the stores’ home pages. Point them at your app or remove them; Apple’s and Google’s badge guidelines apply (Editing the content).

What is the “Default” category? A catch-all category of the original design, with an empty page at /program-category/default and no link in the filters (Editing the content).

Can I remove the style guide, a whole page or a section? Yes:

  • the style guide: delete src/app/style-guide/;
  • a page: see Pages and sections;
  • a section: delete its line in the page file, or set ctaBand or trainersBand to false in the page’s copy.

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 visitors book or pay online? The booking form and the free-trial form send a request to you (Forms); there are no accounts, schedules or payments. Link a booking or payment service from the buttons, or connect one through the webhook provider.

Can I write the site in another language? All the copy is content, so write it in your language. Then set lang in src/app/layout.tsx (and locale in its openGraph and in src/lib/meta.ts) and the date format in src/lib/format.ts ("en-US"). The template has no language switch or language-based routing.

Does the site need a cookie banner? As shipped, the template sets no cookies of its own and the font is served from your own domain. The program pages load the video’s thumbnail from YouTube’s image server, and the player, from youtube-nocookie.com, only when the visitor clicks play. Any analytics or embeds you add are yours to declare. The demo’s Privacy Policy is a sample: have yours say what your site does.

Can I show dates in another format? Yes. Post and legal dates (“Aug 18, 2025”) come from formatDate in src/lib/format.ts.

Will it work with Tailwind plugins, shadcn/ui, or my component library? Yes. It is a standard Next.js + Tailwind CSS 4 project; add packages as usual. The design tokens are plain CSS variables, so other libraries can read them.

How do I update to a new version of the template? Download the new release and copy your src/content/, public/, your icons 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.