Development guide
Use a Next.js development environment
Each project can have one persistent development environment. Use it to combine work on a chosen branch before you send that work to production.
Choose the branch
Create a branch in GitHub for shared development work. The branch must already exist before you connect it in the project.
Use one branch that the team can test together. The portal keeps the same development URL when future pushes update that branch.
Create the environment
- 1Open the project deployment controls.
- 2Choose the development branch.
- 3Create the development environment.
- 4Wait for the first deployment to report healthy.
Keep configuration separate
Open Environment and choose Development to add the values for this app instance. The development environment does not use the production values automatically.
Use safe test accounts and test endpoints when your payment, email, or identity provider supports them.
Deploy and promote the change
- 1Push to the development branch to update the same development URL.
- 2Test the change on that URL.
- 3Merge the reviewed change into the production branch when it is ready.
- 4Check the production deployment after its health check passes.
Know the scope
A project has one persistent development environment. Host Little does not create a separate app for each pull request.
Use GitHub pull requests for code review. Merge the work into the selected development branch when you want a combined test deployment.