DEPLOY.md

@hapi/hapi.dev deployment process

This documentation is aimed for maintainers of the website to deploy a new version. The site is hosted on Netlify.

Testing the release

Prior to deploying the new website version it is best to test it on your local machine. You need to:

1. Make the changes you need to the codebase.
2. Run npm run generate which will build the static dist folder.
3. Run npm run static to view the website with the static dist folder you generated on the previous step.

At this point if everything looks good and you don't notice any regression, you can proceed to the next step.

Deploying

You need to go to Netlify's login page. Once logged in make sure you are on the hapi team account and not your personal one:

Pick the hapi.dev from the list of sites available either from the dashboard or the "sites" tab:

Activate the automatic builds for that site:

We don't keep the automatic build enabled so we don't build the website on every commit push to the repo. This is intended to decrease the build minutes consumption on our account otherwise 💸.

Trigger a deployment:

After the deployment process is done, you can preview the result to make sure everything's working fine from the deployment details page:

If the deployment is ready to be published you can just click the "publish deploy" button:

The new version of the website is now live. Congrats! 🎉🎊

Just one more step and you're good to go, we need to disable the automatic builds once we're done publishing. For that you need to go the "site settings" page either from the top tab or the dashboard:

Just click that "Stop builds" radio button and hit save:

Good job!