Files
next.js/contributing/core/developing.md
T
Sam KoandGitHub 2e977f1614 docs: fix rustup download link (#61007)
## Changes

- Fix URL to `rustup` (Previous URL
https://doc.rust-lang.org/cargo/getting-started/installation is now a
`404`)

Closes NEXT-2191
2024-01-22 16:33:15 -08:00

1.5 KiB

Developing

  • The development branch is canary.
  • All pull requests should be opened against canary.
  • The changes on the canary branch are published to the @canary tag on npm regularly.

To develop locally:

  1. Install Rust and Cargo via rustup.
  2. Install the GitHub CLI.
  3. Clone the Next.js repository (download only recent commits for faster clone):
    gh repo clone vercel/next.js -- --depth=3000 --branch canary --single-branch
    
  4. Create a new branch:
    git checkout -b MY_BRANCH_NAME origin/canary
    
  5. Enable pnpm:
    corepack enable pnpm
    
  6. Install the dependencies with:
    pnpm install
    
  7. Start developing and watch for code changes:
    pnpm dev
    
  8. In a new terminal, run pnpm types to compile declaration files from TypeScript. Note: You may need to repeat this step if your types get outdated.
  9. When your changes are finished, commit them to the branch:
    git add .
    git commit -m "DESCRIBE_YOUR_CHANGES_HERE"
    
  10. 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.