- The development branch is
canary. - All pull requests should be opened against
canary. - The changes on the
canarybranch are published to the@canarytag on npm regularly.
To develop locally:
- Install the GitHub CLI.
- Clone the Next.js repository:
gh repo clone vercel/next.js - Create a new branch:
git checkout -b MY_BRANCH_NAME origin/canary - Enable pnpm:
corepack enable pnpm - Install the dependencies with:
pnpm install - Start developing and watch for code changes:
pnpm dev - In a new terminal, run
pnpm typesto compile declaration files from TypeScript. Note: You may need to repeat this step if your types get outdated. - When you changes are finished commit them to the branch:
git add . git commit -m "DESCRIBE_YOUR_CHANGES_HERE" - To open a pull request you can use the GitHub CLI which automatically forks and sets up a remote branch. Follow the prompts when running:
gh pr create
For instructions on how to build a project with your local version of the CLI, see Developing Using Your Local Version of Next.js as linking the package is not sufficient to develop locally.