Cursor deployment

Next.js Build Error After Changes

After Cursor refactored your Next.js application, the build command fails. The application won't build for production.

The refactored code violates Next.js requirements or broke the build configuration.

Error Messages You Might See

Build failed Unexpected server-only code in client component Image is missing required props API route not found
Build failedUnexpected server-only code in client componentImage is missing required propsAPI route not found

Common Causes

  1. Server component using client-only code (window, hooks in server)
  2. API route using wrong export (named instead of default)
  3. Image dimensions not specified (if using Image component)
  4. Dynamic import syntax incorrect for Next.js
  5. Environment variables not exposed to client

How to Fix It

Add 'use client' directive for client components. API routes: export default function handler(req, res) {}. Images: use next/image with width/height. Dynamic imports: dynamic(() => import('component'), {ssr: false}). Env: prefix with NEXT_PUBLIC_ for client access.

Real developers can help you.

Yovel Cohen Yovel Cohen I got a lot of experience in building Long-horizon AI Agents in production, Backend apps that scale to millions of users and frontend knowledge as well. Daniel Vázquez Daniel Vázquez Software Engineer with over 10 years of experience on Startups, Government, big tech industry & consulting. Jared Hasson Jared Hasson Full time lead founding dev at a cyber security saas startup, with 10 yoe and a bachelor's in CS. Building & debugging software products is what I've spent my time on for forever Matthew Jordan Matthew Jordan I've been working at a large software company named Kainos for 2 years, and mainly specialise in Platform Engineering. I regularly enjoy working on software products outside of work, and I'm a huge fan of game development using Unity. I personally enjoy Python & C# in my spare time, but I also specialise in multiple different platform-related technologies from my day job. Costea Adrian Costea Adrian Embedded Engineer specilizing in perception systems. Latest project was a adas camera calibration system. Taufan Taufan I’m a product-focused engineer and tech leader who builds scalable systems and turns ideas into production-ready platforms. Over the past years, I’ve worked across startups and fast-moving teams, leading backend architecture, improving system reliability, and shipping products used by thousands of users. My strength is not just writing code — but connecting product vision, technical execution, and business impact. Kingsley Omage Kingsley Omage Fullstack software engineer passionate about AI Agents, blockchain, LLMs. Anthony Akpan Anthony Akpan Developer with 8 years of experience building softwares fro startups Mehdi Ben Haddou Mehdi Ben Haddou - Founder of Chessigma (1M+ users) & many small projects - ex Founding Engineer @Uplane (YC F25) - ex Software Engineer @Amazon and @Booking.com AUXLE AUXLE I am a Full Stack Developer experienced in building Websites, Web apps and Cross Platform Mobile Apps for Startups and Companies.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

What's the difference between server and client components?

Server components (default) run on server, no bundle size cost. Client need 'use client' directive, bundle included. Use server when possible.

How do I use environment variables in Next.js?

Prefix with NEXT_PUBLIC_ to expose to client. Access with process.env.NEXT_PUBLIC_VAR in browser.

Related Cursor Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help