Deployment guide
Deploy a Next.js app from GitHub
Use this checklist to create a project, connect its source, and verify the first release before you add a custom domain.
Before you start
Use a production Next.js repository that can build with its normal install, build, and start commands.
Keep the repository available in GitHub. Private repositories need access through the separate GitHub App connection.
Create the project
- 1Sign in with GitHub.
- 2Create an App Hosting project.
- 3Choose the GitHub repository.
- 4Choose the production branch.
Add the values your app needs
Open Environment in the project. Add the production environment variables that your app reads at build time or runtime.
Use the production tab for live values. Use the development tab only for the project development environment.
Deploy and check the project URL
- 1Push the selected branch, or use Redeploy for the current branch.
- 2Open the project URL after the deployment reports healthy.
- 3Check the pages, sign-in flow, and any external services that your app uses.
Add a custom domain when the app is ready
Keep the project URL available while you test the new deployment. Then add the custom domain and complete the DNS records shown in the portal.
Host Little manages HTTPS after the domain points to the project. Keep the old host active until the new domain works as expected.