From 5e0caa0aa4815f1564e6e1f9a61332125fc3c172 Mon Sep 17 00:00:00 2001 From: Jarred Sumner Date: Wed, 25 Jun 2025 03:20:22 -0700 Subject: [PATCH] Create upgrade-webkit.md --- .claude/commands/upgrade-webkit.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 .claude/commands/upgrade-webkit.md diff --git a/.claude/commands/upgrade-webkit.md b/.claude/commands/upgrade-webkit.md new file mode 100644 index 0000000000..c71308bb7f --- /dev/null +++ b/.claude/commands/upgrade-webkit.md @@ -0,0 +1,23 @@ +Upgrade Bun's Webkit fork to the latest upstream version of Webkit. + +To do that: + +- cd vendor/WebKit +- git fetch upstream +- git merge upstream main +- Fix the merge conflicts +- cd ../../ (back to bun) +- make jsc-build (this will take about 7 minutes) +- While it compiles, in another task review the JSC commits between the last version of Webkit and the new version. Write up a summary of the webkit changes in a file called "webkit-changes.md" +- bun run build:local (build a build of Bun with the new Webkit, make sure it compiles) +- After making sure it compiles, run some code to make sure things work. something like ./build/debug-local/bun-debug --print '42' should be all you need +- cd vendor/WebKit +- git commit -am "Upgrade Webkit to the latest version" +- git push +- get the commit SHA in the vendor/WebKit directory of your new commit +- cd ../../ (back to bun) +- Update WEBKIT_VERSION in cmake/tools/SetupWebKit.cmake to the commit SHA of your new commit +- git checkout -b bun/webkit-upgrade- +- commit + push (without adding the webkit-changes.md file) +- create PR titled "Upgrade Webkit to the ", paste your webkit-changes.md into the PR description +- delete the webkit-changes.md file