Skip to content

Update getting started docs to clarify use of --experimental-app flag #122

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

grassfieldk
Copy link

The --experimental-app flag was required for enabling the App Router in early versions of Next.js 14, but is no longer necessary in recent version.

The `--experimental-app` flag was required for enabling the App Router in early versions of Next.js 14, but is no longer necessary in recent version.
Copy link

netlify bot commented Jul 27, 2025

Deploy Preview for contentlayerwebsite ready!

Name Link
🔨 Latest commit e263f1b
🔍 Latest deploy log https://app.netlify.com/projects/contentlayerwebsite/deploys/6885845093eea90008e4f695
😎 Deploy Preview https://deploy-preview-122--contentlayerwebsite.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@grassfieldk
Copy link
Author

The --experimental-app flag was supported up to version 14, but in the latest version it has been removed and is now recognized as a directory name instead.

$ npx create-next-app@14 --typescript --tailwind --experimental-app --eslint contentlayer-example-14
✔ Would you like to use `src/` directory? … No / Yes
✔ Would you like to use App Router? (recommended) … No / Yes
✔ Would you like to customize the default import alias (@/*)? … No / Yes
Creating a new Next.js app in /home/grassfield/work/next/contentlayer-example-14.
$ npx create-next-app@15 --typescript --tailwind --experimental-app --eslint contentlayer-example-15
✔ Would you like your code inside a `src/` directory? … No / Yes
✔ Would you like to use App Router? (recommended) … No / Yes
✔ Would you like to use Turbopack for `next dev`? … No / Yes
✔ Would you like to customize the import alias (`@/*` by default)? … No / Yes
Creating a new Next.js app in /home/grassfield/work/next/--experimental-app.

For this reason, I have removed the flag.

@grassfieldk
Copy link
Author

grassfieldk commented Jul 27, 2025

Come to think of it, the rest of the documentation assumes Next.js 14 or earlier, so just updating this section is not enough.
If you use Next.js 15, you would need to update all of the following steps as well, so it might have been better to use @14 instead of @latest.

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.

1 participant