You are currently viewing the Pages Router documentation for version 15 of Next.js.
src Directory
As an alternative to having the special Next.js app or pages directories in the root of your project, Next.js also supports the common pattern of placing application code under the src folder.
This separates application code from project configuration files which mostly live in the root of a project, which is preferred by some individuals and teams.
To use the src folder, move the app Router folder or pages Router folder to src/app or src/pages respectively.

Good to know:
- The
/publicdirectory should remain in the root of your project.- Config files like
package.json,next.config.jsandtsconfig.jsonshould remain in the root of your project..env.*files should remain in the root of your project.src/apporsrc/pageswill be ignored ifapporpagesare present in the root directory.- If you're using
src, you'll probably also move other application folders such as/componentsor/lib.- If you're using Middleware, ensure it is placed inside the
srcfolder.- If you're using Tailwind CSS, you'll need to add the
/srcprefix to thetailwind.config.jsfile in the content section.- If you are using TypeScript paths for imports such as
@/*, you should update thepathsobject intsconfig.jsonto includesrc/.
Was this helpful?
