Troubleshooting — Compose Digi 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.
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 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 DM Sans” (or Inter).
The fonts are 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 fonts 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 …
A content item lacks a field that src/content/types.ts requires. Your editor names the file and the line; add the
field, or mark it optional in the type. A project needs exactly two images, and a service both a weekly and a
monthly plan.
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 from another address needs its host in images.remotePatterns in
next.config.ts.
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. Crop the photo to the shape you want and keep the subject away from the edges (Editing the content).
The About video doesn’t play, or plays the wrong video.
The Play button opens YouTube’s player with the video in video.youtubeId (src/content/pages/about.ts): the ID only,
not the whole address. Without a connection, behind a firewall that blocks YouTube, or when the video is private or
doesn’t allow embedding, the player stays empty or shows YouTube’s error (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 common cause is a missing field in a content item (the development server doesn’t check types).
The build stops after I added an icon.
The style guide lists every icon on purpose, so a new one must be added to icons in src/app/style-guide/tokens.ts,
or delete src/app/style-guide/ (Making it look like your brand).
The form says “Something went wrong”.
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] New contact request could not be delivered. 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.
The form won’t send and shows “Please enter …” under a field.
The first and last name and the e-mail are required, and the e-mail must look like an address (name@domain.com). The
phone, the message and the services can stay empty.
The 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 project’s service tags are missing, or one is.
The project’s services are slugs from src/content/collections/services.ts, matched exactly: a slug that matches no
service is left out. Check the spelling after renaming a service’s slug.
A new post isn’t first on Blog or Home.
Nothing is sorted by date: the site shows the posts in the order of src/content/collections/posts.ts, newest first in
the demo. Put the new post at the top of the list. Prev and Next on a post follow the same order.
Projects, Blog or Careers show only a few items.
That’s on purpose: “Load More” shows the next ones. Every item is in the page’s HTML from the start. To change the
numbers, set pageSizes (phones, tablets, desktops) in src/content/pages/projects.ts, blog.ts or careers.ts.
Home shows only six services, or a service is missing from the footer.
Home shows the first ones (services.count in src/content/pages/home.ts); the footer’s moving rows show the first eight
services, four in each row. The Services page shows them all.
A link of the footer leads to the 404 page.
The footer’s links are written in footer.columns in src/content/site.ts: when you rename or remove a page, change its
link there too.
The footer’s “Tell Us Your New Ideas” is too big or too small after I changed it.
That line is sized to fill the width with the demo’s words. Change md:text-[8.532cqw] in src/components/site/Footer.tsx
until your words fill it (Making it look like your brand).
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.
Nothing moves: the strips, the project photos, the cursor’s changes. 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). Everything is still there; only the movement is left out.
I don’t see the custom cursor. It follows a mouse only, over the page content: not over the header and the footer, not on touch screens, and not on Contact, a post’s article or the 404 page (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.
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 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, for example
<QuoteSection … />(the founder’s quote) insrc/app/page.tsx.
I don’t show prices. Can I take the plans off the service pages?
Yes: the plan card is part of src/components/sections/ServiceDetailsSection.tsx; remove it there, and “Key Benefits”
can take the whole width. The weekly and monthly fields can then go from the type and the services.
Can I remove the custom cursor?
Yes: delete <Cursor /> from src/app/layout.tsx. The cards hide the system pointer over themselves (cursor-none):
remove that class from the cards in src/design-system/components/cards/ and from the Play button in
media/VideoCard.tsx so the normal pointer shows there.
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 apply for a job on the site? Not as shipped: a job page says how to apply (“How to Apply”, an e-mail link in the demo). To take applications on the site, add a form like the contact form (Forms) or link to your hiring tool.
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), the date format in src/lib/format.ts ("en-US"), and the interface word “Main”
in src/components/site/Header.tsx. The template has no language switch or language-based routing.
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 YouTube’s player when a visitor presses Play, and YouTube may set its own cookies then. Anything you add (analytics, a booking widget, a chat) is yours to declare.
Can I show dates in another format?
Yes. Post dates (“Jun 25, 2024”) come from formatDate in src/lib/format.ts.
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.
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.