Improved contribution docs for building locally (#79)

* Modified the desktop app building docs with more info and some fixes. Fixed the docs for webpage contributing guide.

* Update www.md

fixed a typo
This commit is contained in:
RayZ3R0 2024-10-29 23:07:24 +06:00 committed by GitHub
parent 5157abcb08
commit 5e02a4b29a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 57 additions and 23 deletions

View file

@ -22,8 +22,9 @@ Before you begin, ensure you have the following tools installed:
Clone the project
```bash
git clone https://github.com/zen-browser/desktop.git --recurse-submodules
git clone --depth 1 https://github.com/zen-browser/desktop.git
cd desktop
git submodule update --init --recursive --depth 1
```
Install dependencies
@ -34,27 +35,50 @@ npm i
Download and bootstrap the browser
```
```bash
npm run init
```
Copy a language pack
Run bootstrap to identify and fix potential errors
```bash
npm run bootstrap
```
Copy a language pack
```bash
sh scripts/update-en-US-packs.sh
```
Start building the browser
```
```bash
npm run build
```
Finally, run the browser!
```
```bash
npm start
```
### Limiting CPU Usage During Build
On Linux, you can use cpulimit to restrict CPU usage of intensive build processes:
```bash
# Limit by process name
cpulimit -e rustc -l 50 # Limits rustc to 50% CPU
cpulimit -e clang -l 50 # Limits clang to 50% CPU
# Or limit by PID
cpulimit -p PID -l 50
```
On Windows, use Process Lasso or Process Hacker to set CPU affinity and priority:
1. Open Process Lasso/Process Hacker
2. Find rustc.exe or clang.exe processes
3. Right click -> Set CPU Affinity/Priority
## Making a Contribution

View file

@ -41,17 +41,27 @@ npm install
This command installs all the necessary packages listed in the `package.json` file.
## Step 4: Start the Development Server
## Step 4: Build the Project
To build the project files:
```bash
npm run build
```
This command will compile and process all the source files into a production-ready format.
## Step 5: Start the Development Server
After installing the dependencies, you can start the development server:
```bash
npm start
npm run dev
```
This command will start a local server and open the homepage in your default web browser. The server will automatically reload whenever you make changes to the code.
## Step 5: Make Your Changes
## Step 6: Make Your Changes
You can now start making changes to the homepage. The project structure is as follows:
@ -61,11 +71,11 @@ You can now start making changes to the homepage. The project structure is as fo
Feel free to explore and modify the files to implement new features or fix bugs.
## Step 6: Test Your Changes
## Step 7: Test Your Changes
Before submitting your changes, make sure they work as expected. Check the functionality across different pages and ensure that your changes do not introduce any new issues.
## Step 7: Commit and Push Your Changes
## Step 8: Commit and Push Your Changes
Once you are satisfied with your changes, commit them to your local repository:
@ -80,7 +90,7 @@ Push your changes to your forked repository:
git push origin main
```
## Step 8: Create a Pull Request
## Step 9: Create a Pull Request
After pushing your changes, go to the original Zen Browser Homepage Repository and submit a pull request: