How to deploy

0. Make sure the dependency on the open source project (e.g. project-x) is pinned to a specific version (instead of "project-x": "*", which it may have been previously).

1. Check the static build is working correctly:

   # Build the static HTML/JS files to the `/build` directory
   builder run build-static 
   
   builder concurrent server-static open-static 
   

   Open your browser to http://0.0.0.0:8080 to test it locally.

2. Publish a new version of the docs site (e.g. project-x-docs) to npm.

   Versioning Notes

   For a reliable systems of releases, the docs site should aim for versioning along these lines:

   • Patch: Typos, missing assets, broken styles, very minor copyedits.
   • Minor: Add a new page, change styles.
   • Major: Rearchitect how the lander works, remove pages, or something else huge.

3. Create a new pull request in formidable.com-aws that points to the new version of the docs site (e.g. project-x-docs) in the dependencies ...and then just read the instructions!