Deployment and access
Prerequisites
- Confirm the GitHub Actions
Docs buildworkflow passes. - Generate and commit
package-lock.jsonwith Node 22 andnpm install. Then switch CI tonpm ci. - Import
MR0808/sparelane-docsinto a dedicated Vercel project. Use framework preset Docusaurus if offered, otherwise use Other, build commandnpm run build, output directorybuild, install commandnpm cionce the lockfile exists. - Configure
docs.sparelane.coas the custom domain and follow the DNS instructions provided by Vercel. - Before sharing any URL, restrict production, preview and generated
*.vercel.appdeployment URLs using an access-control mechanism that protects every deployment. A private GitHub repository does not make a Vercel deployment private. - Test access as an unauthenticated visitor, then as each approved reviewer.
- Invite Pete and John to the private GitHub repository only if they should be able to read and comment on GitHub Issues; GitHub Issues are not embedded website comments.
Security
Do not rely on a client-side password prompt or obscured URL. Check Vercel Deployment Protection plan features and compatibility with your preferred login experience; if necessary, use a server-side authentication gateway with origin bypass prevention. Do not enable a public deployment as a temporary shortcut.
Feedback
Use repository issues for suggestions and decision requests. Record accepted outcomes in the decision register.