diff --git a/content/assets/building/ignored-builds-warning.png b/content/assets/building/ignored-builds-warning.png new file mode 100644 index 0000000..cb16efc Binary files /dev/null and b/content/assets/building/ignored-builds-warning.png differ diff --git a/content/building.md b/content/building.md index 4aed744..db1f8b3 100644 --- a/content/building.md +++ b/content/building.md @@ -1,6 +1,6 @@ --- title: Building Zen Browser 📦 -lastmod: 2024-09-25 +lastmod: 2025-03-06 --- We've taken the time to make building Zen Browser as easy as possible, independent of your operating system or technical knowledge. @@ -29,6 +29,14 @@ npm i This command will install all the packages listed in the `package.json` file, which are required for building and running Zen Browser. +If you see this error message: + +
+ +
+ +Run `pnpm approve-builds` and approve them. + ## Step 3: Download and Bootstrap the Browser To set up the browser, you need to download additional files and prepare the environment: @@ -68,3 +76,38 @@ npm start ``` This command launches the browser, allowing you to see your changes in action. + +# Troubleshooting + +
+[Windows] Error: ccache not found + +Add `C:\Users\\.mozbuild\sccache` to your PATH. + +
+ +
+[Windows] Error: 7z not found + +Download 7-zip and add it to your PATH. + +
+ +
+[All OS] My code changes are not being reflected even after building + +If you are changing files in the `src/` directory: + +```bash +pnpm run import +pnpm run build:ui +``` + +
+ +
+[All OS] Something went wrong installing the "sharp" module + +You likely did not approve builds in [Step 2](#step-2-install-dependencies). + +
diff --git a/quartz/styles/custom.scss b/quartz/styles/custom.scss index b0c09dc..d57e566 100644 --- a/quartz/styles/custom.scss +++ b/quartz/styles/custom.scss @@ -1,3 +1,7 @@ @use "./base.scss"; // put your custom CSS here! + +summary { + cursor: pointer; + } \ No newline at end of file