Skip to content
Sign inJoin waitlist

Troubleshooting — KorDent 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 Inter”. 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 'ServiceIcon' A content item lacks a field that src/content/types.ts requires, or names an icon that doesn’t exist. Your editor names the file and the line; add the field, or pick a name from the list in types.ts.

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. Crop the photo to the shape you want and keep the subject away from the edges (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).

A 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 appointment request could not be delivered (or “New contact message”, “New patient review”, “New newsletter subscriber”). 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.

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.

The booking form lists no dentist for a treatment. The dentists of a treatment are the slugs in the service’s doctors list in src/content/collections/services.ts; each must match a slug in doctors.ts. Until a treatment is chosen, the form lists every dentist.

A new service doesn’t show on the Services page. The page shows at most list.limit services (14, the demo’s count) in src/content/pages/services.ts: raise it. Home shows the first six that match the chosen tab (services.limit in home.ts).

A service doesn’t appear under its department tab. Its category must be the slug of a department in categories.ts ("preventive-care", not “Preventive Care”).

A review or an outcome shows a slug instead of a treatment’s name. Its service (or services) names a slug that no service has. Fix the spelling, or add the service.

A new post isn’t first in the Blog. The Blog doesn’t sort by date: it 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.

“Call Now” dials the demo’s number. The buttons carry typed tel: links: search src/content/ for “555” and replace each (Editing the content).

The map on Contact shows the wrong place. The map and “Get Direction” search Google Maps for contact.address in src/content/site.ts. Write the address the way Google finds it.

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 blocks, the words. 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). Blocks fade in without rising and the video stays still.

The video does not play. It plays when the call to action is on the screen, muted and in a loop, and never for visitors who prefer reduced motion. If it doesn’t play for you either, check cta.video.src in src/content/site.ts: /videos/cta.mp4 for a file in public/videos/, or a working address, and an MP4 the browser can play (Editing the content).

A legal link in the footer leads to the 404 page. footer.legalLinks in src/content/site.ts are typed addresses: /legal/<slug> must match a slug in src/content/collections/legal.ts.

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, a section or the video? 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 <OutcomesSection … /> in src/app/page.tsx;
  • the video: Editing the content.

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

Does the booking form connect to a calendar or practice software? Not by itself: a booking is a request that reaches you like the other forms. Send it to your practice software or a scheduling tool through the webhook provider (most offer an API, or connect through Zapier or Make), or replace the Book page’s form with your booking tool’s embed (Forms).

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 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 Contact page embeds a Google Maps view, which loads from Google and may set Google’s cookies; declare it, or replace it with a static picture and the “Get Direction” link. Any analytics you add are yours to declare too. The demo’s Privacy Policy is a sample: edit it to match what your site does.

Can I show dates in another format? Yes. Post, review and legal dates (“Mar 12, 2026”) 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.