11---
2- title : Browser
2+ title : Building Zen
33---
4- import { Accordion , Accordions } from ' fumadocs-ui/components/accordion ' ;
4+ import { Tabs , Tab } from ' fumadocs-ui/components/tabs ' ;
55
66We've taken the time to make building Zen Browser as easy as possible, independent of your operating system or technical knowledge.
77
@@ -13,8 +13,6 @@ The following resources are essential for a successful build. Without them, you
1313- Git ([ Download here] ( https://git-scm.com/downloads ) ) – Required for version control and managing source code.
1414- Python 3 ([ Download here] ( https://www.python.org/downloads/ ) ) – Needed for running build scripts and automation tools.
1515- Node.js 21+ ([ Download here] ( https://nodejs.org/ ) ) – Required for managing dependencies and running JavaScript-based tools.
16- - MozillaBuild ([ Download here] ( https://wiki.mozilla.org/MozillaBuild ) ) – Required for ` mach ` and Gecko compilation.
17- - 7-Zip ([ Download here] ( https://www.7-zip.org/download.html ) ) – Used to extract Firefox source archives.
1816- sccache ([ Download here] ( https://github.com/mozilla/sccache/releases ) ) – A caching tool that speeds up rebuilds by storing compiled objects.
1917
2018<Callout >
@@ -25,16 +23,45 @@ If you're using Windows, ensure that all the basic software requirements are add
2523We cannot provide support if a build fails. Please understand this before proceeding with the following steps.
2624</Callout >
2725
28- ## Step 1: Clone the Project
29-
30- First, you need to clone the Zen Browser repository to your local machine. This will create a local copy of the project that you can work on.
26+ ## Step 1: Getting Started & Clone the Project
27+
28+ First, let's get your system ready for building Zen.
29+
30+ <Tabs groupId = " toolbar" items = { [' Windows' , ' Linux' , ' macOS' ]} persist >
31+ <Tab value = " Windows" >
32+ <p >Follow the steps below to set up your Windows environment for building Zen Browser:</p >
33+ <ol >
34+ <li >Install [ MozillaBuild] ( https://wiki.mozilla.org/MozillaBuild ) and add it to your ` PATH ` .</li >
35+ <li >Install [ 7-Zip] ( https://www.7-zip.org/ ) and add it to your ` PATH ` .</li >
36+ <li >Ensure you have Visual Studio with the "Desktop development with C++" workload installed.</li >
37+ </ol >
38+ </Tab >
39+ <Tab value = " Linux" >
40+ <p >Follow the steps below to set up your Linux environment for building Zen Browser:</p >
41+ <ol >
42+ <li >For Debian-based Linux (such as Ubuntu): ` sudo apt update && sudo apt install curl python3 python3-pip git ` </li >
43+ <li >` For Fedora Linux: sudo dnf install python3 python3-pip git ` </li >
44+ </ol >
45+ </Tab >
46+ <Tab value = " macOS" >
47+ <p >Follow the steps below to set up your macOS environment for building Zen Browser:</p >
48+ <ol >
49+ <li >Install Xcode from the App Store, after that run the following command in your terminal:</li >
50+ ```
51+ sudo xcode-select --switch /Applications/Xcode.app
52+ sudo xcodebuild -license
53+ ```
54+ </ol >
55+ </Tab >
56+ </Tabs >
57+
58+ After having everything set up, you need to clone the Zen Browser repository to your local machine. This will create a local copy of the project that you can work on.
3159
3260``` bash
33- git clone https://github.com/zen-browser/desktop.git --recurse-submodules -- depth 10
61+ git clone https://github.com/zen-browser/desktop.git --depth 10
3462cd desktop
3563```
3664
37- - ** ` --recurse-submodules ` ** : This flag ensures that all submodules are cloned along with the main project. Zen Browser relies on several submodules, so this step is essential.
3865- ** ` --depth 10 ` ** : This makes sure you dont download the entire git history, it would take a long time otherwise due to that we used to store compiled binaries on the repository.
3966
4067## Step 2: Install Dependencies
0 commit comments