Skip to content

ci: cache Vite Task output for docs builds #2006

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fengmk2 merged 15 commits into from
Jul 2, 2026
+55 −2
Merged

ci: cache Vite Task output for docs builds #2006

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
3edb0c8
ci(docs): enable cached docs build task
wan9chi Jul 1, 2026
ea8ea96
build(netlify): remove Node version override
wan9chi Jul 1, 2026
d410ab0
build(docs): trim build cache inputs
wan9chi Jul 1, 2026
5fa8b84
build(docs): restore Vite temp cache exclusion
wan9chi Jul 1, 2026
43c4292
build(docs): rely on tracked build outputs
wan9chi Jul 1, 2026
4ed06e0
ci(docs): cache task builds in Actions
wan9chi Jul 1, 2026
a0ffeef
ci(docs): run deploy build once
wan9chi Jul 1, 2026
b5b5bd7
build(docs): ignore Vite temp directory listing
wan9chi Jul 1, 2026
a129dfd
ci(docs): clarify task cache steps
wan9chi Jul 1, 2026
1b66ae6
build(docs): restore build output tracking
wan9chi Jul 1, 2026
f89f484
ci(docs): document task cache restore order
wan9chi Jul 1, 2026
83d4429
build(docs): remove redundant Vite temp input
wan9chi Jul 1, 2026
79ffad1
ci(docs): use pkg.pr.new Vite+ for docs cache
wan9chi Jul 2, 2026
7b7f75f
build(docs): set explicit build output
wan9chi Jul 2, 2026
a8e3267
ci(docs): use released Vite+ for deploy builds
wan9chi Jul 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions .github/workflows/deploy-docs-preview.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,9 +37,27 @@ jobs:
working-directory: docs
cache-dependency-path: docs/pnpm-lock.yaml

- name: Restore docs Vite Task cache
id: vite-task-cache
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
with:
path: docs/node_modules/.vite/task-cache
key: vite-task-docs-${{ runner.os }}-${{ runner.arch }}-pr-${{ github.event.pull_request.number }}-${{ github.event.pull_request.head.sha }}
# Prefer this PR's newest cache, then fall back to main for new PRs.
restore-keys: |
vite-task-docs-${{ runner.os }}-${{ runner.arch }}-pr-${{ github.event.pull_request.number }}-
vite-task-docs-${{ runner.os }}-${{ runner.arch }}-main-

- run: vp run build
working-directory: docs

- name: Save docs Vite Task cache
if: success() && steps.vite-task-cache.outputs.cache-hit != 'true'
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
with:
path: docs/node_modules/.vite/task-cache
key: ${{ steps.vite-task-cache.outputs.cache-primary-key }}

- run: vpx void deploy --dir docs/.vitepress/dist
env:
VOID_TOKEN: ${{ secrets.VOID_TOKEN }}
Expand Down
17 changes: 17 additions & 0 deletions .github/workflows/deploy-docs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,9 +37,26 @@ jobs:
working-directory: docs
cache-dependency-path: docs/pnpm-lock.yaml

- name: Restore docs Vite Task cache
id: vite-task-cache
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
with:
path: docs/node_modules/.vite/task-cache
key: vite-task-docs-${{ runner.os }}-${{ runner.arch }}-main-${{ github.sha }}
# Restore the latest main cache; Vite Task fingerprints decide reuse.
restore-keys: |
vite-task-docs-${{ runner.os }}-${{ runner.arch }}-main-

- run: vp run build
working-directory: docs

- name: Save docs Vite Task cache
if: success() && steps.vite-task-cache.outputs.cache-hit != 'true'
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
with:
path: docs/node_modules/.vite/task-cache
key: ${{ steps.vite-task-cache.outputs.cache-primary-key }}

- run: vpx void deploy --dir docs/.vitepress/dist
env:
VOID_TOKEN: ${{ secrets.VOID_TOKEN }}
3 changes: 2 additions & 1 deletion docs/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@
"type": "module",
"scripts": {
"dev": "vitepress dev",
"build": "cp ../packages/cli/install.sh ../packages/cli/install.ps1 public/ && vitepress build",
"build": "cp ../packages/cli/install.sh ../packages/cli/install.ps1 public/ && vp run build:site",
"build:netlify": "cp ../packages/cli/install.sh ../packages/cli/install.ps1 public/ && vitepress build",
"preview": "vitepress preview",
"update-trusted-stack-stats": "node .vitepress/theme/data/fetch-trusted-stack-stats.ts"
},
Expand Down
17 changes: 17 additions & 0 deletions docs/vite.config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
export default {
run: {
tasks: {
'build:site': {
command: 'vitepress build',
input: [
{ auto: true },
'!.vitepress/.temp/**',
'!.vitepress/dist/**',
'!node_modules',
Comment thread
wan9chi marked this conversation as resolved.
'!node_modules/.vite-temp/**',
],
output: ['.vitepress/dist/**'],
},
},
},
};
2 changes: 1 addition & 1 deletion netlify.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[build]
base = "docs/"
command = "pnpm build"
command = "pnpm build:netlify"
publish = ".vitepress/dist"

# Windows installer redirect
Expand Down
Loading