Skip to content
Sign inJoin waitlist

Troubleshooting — Denzel Next.js

Most problems with this Next.js template come from a content typo, a slug that no longer matches, 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 Noto Serif JP” (or Poppins). 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).

The build stops with Home: no post "<slug>". Editor’s Pick or Trending names a post that doesn’t exist: you renamed or deleted it. Change the slug in picks or trending in src/content/pages/home.ts (Editing the content).

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. A category or an author without a photo needs "image": null or "avatar": null, not a missing field.

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 one post photo appears in frames of many shapes (wide on its page, square in the lists, round in Recent). Keep the subject in the middle (Editing the content).

A card shows a slug (“travel”) instead of a name, and its link leads to the 404 page. The post’s category or author names a slug that isn’t in categories.ts or authors.ts. Write it exactly as there.

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 newsletter box says “Something went wrong”. The address doesn’t look like an e-mail, 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 newsletter subscriber 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 box says “Thank you!” but nothing arrives. With FORM_PROVIDER=console (the default, also when the variable is missing) sign-ups are only written to the server log: set a provider (Forms). With Mailchimp’s default status, transactional, the contact is in your audience but not subscribed to campaigns (Forms).

A new post isn’t on Home’s slider, Editor’s Pick, Trending, Recent or the footer. Those blocks show the posts named by slug (Editing the content): add its slug there. Latest, Blog and the category and author pages show it by itself.

A new post isn’t first. The lists are sorted by date, newest first: check the post’s date ("2026-11-02", year, month, day). Posts of the same date keep the order of posts.ts.

A post in the slider, Recent or the footer disappeared. Its slug no longer matches a post, and those blocks skip it. Fix the slug in home.ts or site.ts.

“Related Posts” or “More Articles by” is missing under a post. No other post shares the category, or the author has no other post; the block is left out then.

Home shows only eight posts in Latest. That’s latest.count in src/content/pages/home.ts; “View More” leads to Blog, which lists them all.

A category or author page says “No posts in this category yet.” No post names that category or author: the demo’s “Uncategory” and “Admin” are like that on purpose. Delete them, or give them posts.

The search doesn’t find a category or an author. The search lists only categories and authors that have posts. A post is found by its title, excerpt, category and author, and every word typed must match.

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 slider or the photos don’t move. 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 slider also stands still when it has no more posts than fit on the screen.

Vercel doesn’t deploy when I push. If the folder has a vercel.json with "git": { "deploymentEnabled": false }, automatic deployments are off: delete the entry (Going live).

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.

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 <HomeSlider … /> in src/app/page.tsx; a block of Home’s column (Editor’s Pick, Trending, Latest) in src/components/sections/HomeContent.tsx.

Can I have a single author? Yes: keep one entry in authors.ts and name it in every post. Point the menu’s “Author” link at it, or remove the link.

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 add comments to the posts? Not built in. Add a comments service (Giscus, Disqus, Commento…) as a component at the end of src/components/sections/PostContent.tsx, and declare it in your privacy policy.

Can I show the Blog page in pages (“load more”)? Blog lists every post on one page. To split it, slice the list in src/app/blog/page.tsx, or build numbered pages with a new route.

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 words (“Main”, “Breadcrumb”, “Close search”, “Clear”) listed in Editing the content. 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. Anything you add (analytics, comments, embedded videos) is yours to declare.

Can I show dates in another format? Yes. Post dates (“Sep 14, 2023”) 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.