Make VuePress base, dest and sitemap hostname configurable

[qunabu]

Summary

• Move hardcoded base: '/' and the implicit dist output path out of docs/.vuepress/config.js so the docs site can be deployed under a sub-path (e.g. /docs/) without editing the config file.
• Add docs/.vuepress/build.config.js as a single place to set production values (base: '/docs/', dest: 'docs/.vuepress/dist/docs', sitemap hostname).
• Resolution order for each setting: env var (DOCS_BASE / DOCS_DEST / DOCS_HOSTNAME) → build.config.js → existing built-in default. base is normalized to start and end with /.
• No sitemap plugin change needed — vuepress-plugin-sitemap already prepends base to every URL and writes sitemap.xml into the configured dest.

Test plan

• npm run docs:build completes successfully.
• Output is written to docs/.vuepress/dist/docs/ (not docs/.vuepress/dist/).
• docs/.vuepress/dist/docs/index.html references assets under /docs/....
• docs/.vuepress/dist/docs/sitemap.xml exists and every <loc> is https://hyperformula.handsontable.com/docs/....
• Overriding via env still works: DOCS_BASE=/ DOCS_DEST=docs/.vuepress/dist npm run docs:build reproduces the old layout.
• npm run docs:dev still serves locally.

---

Note

Medium Risk
Medium risk because it changes docs build/deploy configuration (base path, output directory, sitemap hostname) and upgrades the expected Node version to 18, which could affect CI/hosting builds if environments aren’t aligned.

Overview
Makes the VuePress docs build configurable by introducing docs/.vuepress/build.config.js and allowing DOCS_BASE, DOCS_DEST, and DOCS_HOSTNAME to override base, build output dest, and sitemap hostname (with base normalized to include leading/trailing /).

Updates deployment defaults to publish docs under /docs/ and output to docs/.vuepress/dist/docs, and adds netlify.toml plus a .nvmrc bump to Node 18 to align the build environment.

^{Reviewed by Cursor Bugbot for commit 67f6148. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

New default base breaks hardcoded favicon head paths

Medium Severity

Setting the default base to '/docs/' causes the existing head entries for favicons and the web manifest to break. VuePress 1.x does not auto-prepend base to href attributes in head config entries. The five favicon/manifest links still reference /favicon/... instead of /docs/favicon/..., so they will 404 when deployed under the new default sub-path.

Additional Locations (1)

• docs/.vuepress/config.js#L83-L84

 

^{Reviewed by Cursor Bugbot for commit 1c77a8b. Configure here.}

[github-actions]

Performance comparison of head (67f6148) vs base (1852159)

                                     testName |   base |   head | change
------------------------------------------------------------------------
                                      Sheet A | 508.08 | 516.58 | +1.67%
                                      Sheet B | 165.97 | 167.47 | +0.90%
                                      Sheet T | 146.54 | 145.82 | -0.49%
                                Column ranges | 483.57 | 479.57 | -0.83%
Sheet A:  change value, add/remove row/column |  16.33 |  16.05 | -1.71%
 Sheet B: change value, add/remove row/column | 140.84 | 141.97 | +0.80%
                   Column ranges - add column | 154.85 | 160.93 | +3.93%
                Column ranges - without batch | 479.46 | 484.24 | +1.00%
                        Column ranges - batch | 123.48 | 122.74 | -0.60%

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 67f6148. Configure here.}

[cursor]

Non-root base breaks hardcoded head asset paths

High Severity

Changing base from '/' to DOCS_BASE (defaulting to '/docs/') breaks the head config entries which use hardcoded absolute paths like /favicon/apple-touch-icon.png. VuePress 1.x does not auto-prepend base to head tag attributes, so these will 404 in production since the actual assets are served under /docs/favicon/....

Additional Locations (1)

• docs/.vuepress/build.config.js#L8-L9

 

^{Reviewed by Cursor Bugbot for commit 67f6148. Configure here.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.18%. Comparing base (1852159) to head (67f6148).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #1663      +/-   ##
===========================================
+ Coverage    96.77%   97.18%   +0.41%     
===========================================
  Files          174      174              
  Lines        15086    15086              
  Branches      3223     3223              
===========================================
+ Hits         14599    14662      +63     
+ Misses         487      424      -63     

see 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.