Skip to content

Latest commit

 

History

History
38 lines (27 loc) · 1.35 KB

README.md

File metadata and controls

38 lines (27 loc) · 1.35 KB
Raw

Deploying to GitHub Pages

This example supports deploying a statically exported Next.js application to GitHub Pages.

The out directory should not be ignored by version control.

How to use

Execute create-next-app with npm, Yarn, or pnpm to bootstrap the example:

npx create-next-app --example github-pages github-pages-app
yarn create next-app --example github-pages github-pages-app
pnpm create next-app --example github-pages github-pages-app

Deploy to GitHub Pages

  1. Create a new public GitHub repository.
  2. Edit next.config.js to match your GitHub repository name:
    • Given the pattern https://github.com/<user>/<repo>, update your basePath config to /repo.
  3. Push the starter code to the main branch.
  4. Run the deploy script (e.g. npm run deploy) to create the gh-pages branch.
  5. On GitHub, go to Settings > Pages > Branch, and choose gh-pages as the branch with the /root folder. Hit Save.
  6. Make a change.
  7. Run the deploy script again to push the changes to GitHub Pages.

Congratulations! You should have a URL like:

https://<github-user-name>.github.io/<github-project-name>/