Skip to content

docs: add Next.js Deno build troubleshooting#3395

Merged
magurotuna merged 2 commits into
mainfrom
avocet/nextjs-deno-deploy-docs
Jul 8, 2026
Merged

docs: add Next.js Deno build troubleshooting#3395
magurotuna merged 2 commits into
mainfrom
avocet/nextjs-deno-deploy-docs

Conversation

@avocet-bot

@avocet-bot avocet-bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add Deno Deploy Next.js compatibility notes for ESM config, the known Next.js-on-Deno lint/type-check crash, and browser-only prerender failures
  • update the Next.js tutorial with next.config.mjs guidance and build troubleshooting
  • fix the tutorial text to refer to the "use client" directive

Validation

  • deno fmt --check deploy/reference/frameworks.md examples/tutorials/next.md

@avocet-bot
avocet-bot force-pushed the avocet/nextjs-deno-deploy-docs branch from 19f93d2 to 7597dfd Compare July 7, 2026 10:30
@avocet-bot
avocet-bot force-pushed the avocet/nextjs-deno-deploy-docs branch from 7597dfd to 6f7c475 Compare July 7, 2026 11:05
@magurotuna

Copy link
Copy Markdown
Member

Could we clarify the next/dynamic workaround for App Router here?

{ ssr: false } only works for Client Components. In Server Components, Next.js errors with ssr: false is not allowed with next/dynamic; the dynamic import needs to be moved into a Client Component wrapper.

As written, this can read as if users can apply dynamic(..., { ssr: false }) directly from any App Router page/server component, which may lead to a second build error while following the troubleshooting advice.

@magurotuna magurotuna left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me. The App Router next/dynamic / ssr: false caveat is now clear, and the focused docs checks pass locally.

@magurotuna

Copy link
Copy Markdown
Member

We'll fix the build issue later

@magurotuna
magurotuna merged commit 5f8bd07 into main Jul 8, 2026
2 of 3 checks passed
@magurotuna
magurotuna deleted the avocet/nextjs-deno-deploy-docs branch July 8, 2026 08:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants