src Directory
Last updated April 24, 2025
As an alternative to having the special Next.jsapp orpages directories in the root of your project, Next.js also supports the common pattern of placing application code under thesrc 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 thesrc folder, move theapp Router folder orpages Router folder tosrc/app orsrc/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 Proxy, 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 thecontent section.- If you are using TypeScript paths for imports such as
@/*, you should update thepathsobject intsconfig.jsonto includesrc/.
Was this helpful?