CapRover Website

Source for caprover.com, containing two independently built applications:

• homepage/: Next.js static homepage
• website/: Docusaurus v1 documentation
• docs/: documentation Markdown
• scripts/: composition and production smoke checks

The production build uses Docusaurus as the base, then overlays the homepage's index.html, _next/, and homepage-assets/ output. homepage/ is the source of truth for the root homepage.

Homepage development

Requires Node.js 22.13 or newer.

cd homepage
npm ci
npm run dev

Run checks:

npm run lint
npm test

Documentation development

The legacy Docusaurus build currently requires Node.js 10.

cd website
npm install
npm start

Add Markdown files in docs/ and register them in website/sidebars.json.

Build the combined site

From the repository root:

(cd website && npm install && npm run clean-build)
(cd homepage && npm ci && npm run lint && npm test)
node scripts/compose-site.mjs
node scripts/smoke-combined-site.mjs

The deployable artifact is written to build/combined-site/.

Deployment

Pushes to master run .github/workflows/website-publish.yml, build both applications, compose and smoke-test the artifact, then publish it to GitHub Pages. Do not publish either framework's output directly.