diff --git a/content/docs/contribute/desktop/building.mdx b/content/docs/contribute/desktop/building.mdx index 001e7f0..3fc193d 100644 --- a/content/docs/contribute/desktop/building.mdx +++ b/content/docs/contribute/desktop/building.mdx @@ -10,13 +10,13 @@ We've taken the time to make building Zen Browser as easy as possible, independe The following resources are essential for a successful build. Without them, you will encounter unnecessary build failures: - Disk Space: Keep _30GB_ of free space on the disk (the build process is resource-intensive). -- Git ([Download here](https://git-scm.com/downloads)) – Required for version control and managing source code. -- Python 3 ([Download here](https://www.python.org/downloads/)) – Needed for running build scripts and automation tools. -- Node.js 21+ ([Download here](https://nodejs.org/)) – Required for managing dependencies and running JavaScript-based tools. -- sccache ([Download here](https://github.com/mozilla/sccache/releases)) – A caching tool that speeds up rebuilds by storing compiled objects. +- Git ([Download](https://git-scm.com/downloads)) – Required for version control and managing source code. +- Python 3 ([Download](https://www.python.org/downloads/)) – Required for running build scripts and automation tools. +- Node.js 21+ ([Download](https://nodejs.org/)) – Required for managing dependencies and running JavaScript-based tools. +- sccache ([Download](https://github.com/mozilla/sccache/releases)) – A caching tool that speeds up rebuilds by storing compiled objects. -If you're using Windows, ensure that all the basic software requirements are added to the `PATH` variable. +If you're using Windows, ensure that all the basic software requirements are added to `PATH`. @@ -64,7 +64,7 @@ git clone https://github.com/zen-browser/desktop.git --depth 10 cd desktop ``` -- **`--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. +- **`--depth 10`**: This ensures that your host doesn't download the entire Git history, which would take far too long, due to the fact that Zen used to store compiled binaries on the repository. ## Step 2: Install Dependencies @@ -94,7 +94,7 @@ Before building the browser, it’s recommended to update the American English l python3 ./scripts/update_en_US_packs.py ``` -This script updates the "en-US" localization files, which are necessary for proper language support in Zen Browser. Running this step ensures that your build includes the latest translations and language resources. +This script updates the **en-US** localization files, which are necessary for proper language support in Zen Browser. Running this step ensures that your build includes the latest translations and language resources. ## Step 5: Build the Browser diff --git a/content/docs/contribute/desktop/code-structure-and-prefs.mdx b/content/docs/contribute/desktop/code-structure-and-prefs.mdx index 458a8a5..042e40d 100644 --- a/content/docs/contribute/desktop/code-structure-and-prefs.mdx +++ b/content/docs/contribute/desktop/code-structure-and-prefs.mdx @@ -6,14 +6,14 @@ description: Zen Browser Code Structure and Preference Management The Zen Browser is a fork of Firefox with custom features like vertical tabs, workspaces, and themes. The source code is organized in the `src/` directory, with patches and custom implementations for Zen-specific features. ## Main Directories -- **src/zen/**: Contains Zen-specific features. - - `workspaces/`: Implements workspace functionality (e.g., ZenWorkspaces.mjs, ZenWorkspace.mjs). +- `src/zen/`: Contains Zen-specific features. + - `workspaces/`: Implements workspace functionality (e.g., `ZenWorkspaces.mjs`, `ZenWorkspace.mjs`). - `compact-mode/`: Handles compact mode UI. - `glance/`: Quick tab preview feature. - - `common/`: Shared utilities like ZenUIManager.mjs and ZenStartup.mjs. + - `common/`: Shared utilities like `ZenUIManager.mjs` and `ZenStartup.mjs`. - `tabs/`: Tab management, including pinned tabs. -- **src/browser/**: Browser components with patches (e.g., browser.xhtml patches). -- **prefs/**: Preference files in YAML format for various features (e.g., zen.yaml for general prefs, glance.yaml for glance feature). +- `src/browser/`: Browser components with patches (e.g., `browser.xhtml` patches). +- `prefs/`: Preference files in YAML format for various features (e.g., `zen.yaml` for general prefs, `glance.yaml` for the Glance feature). ## How to Add New Preferences Preferences in Zen Browser are defined in YAML files under `prefs/`. These are loaded and applied to customize behavior. @@ -28,12 +28,12 @@ Preferences in Zen Browser are defined in YAML files under `prefs/`. These are l ``` 2. **Define the Pref**: - - `name`: The preference key (e.g., 'zen.workspaces.enable-feature'). + - `name`: The preference key (e.g., `zen.workspaces.enable-feature`). - `value`: Default value (bool, string, int). - *`condition`: Optional* 3. **Integrate in Code**: - - Use `Services.prefs.getBoolPref('zen.workspaces.new-pref', defaultValue)` in JavaScript files (e.g., ZenWorkspaces.mjs). + - Use `Services.prefs.getBoolPref('zen.workspaces.new-pref', defaultValue)` in JavaScript files (e.g., `ZenWorkspaces.mjs`). 4. **Build and Test**: - Rebuild the browser. diff --git a/content/docs/contribute/docs/editing-with-vscode.mdx b/content/docs/contribute/docs/editing-with-vscode.mdx index 1b7fba6..351e0af 100644 --- a/content/docs/contribute/docs/editing-with-vscode.mdx +++ b/content/docs/contribute/docs/editing-with-vscode.mdx @@ -9,9 +9,12 @@ Visual Studio Code (VS Code) is a popular and powerful code editor that works we ## Prerequisites - [**Visual Studio Code**](https://code.visualstudio.com/) installed on your machine. - - *Note: Popular forks of VS Code, such as [VSCodium](https://vscodium.com/), should also work well.* -## Recommended Extension: MDX + + Popular forks of VS Code, such as [VSCodium](https://vscodium.com/), should also work well. + + +## MDX Extension To get the best experience editing `.mdx` files in VS Code, we recommend installing the official MDX extension. @@ -47,7 +50,7 @@ To get the best experience editing `.mdx` files in VS Code, we recommend install - Syntax highlighting for Markdown and JSX - IntelliSense suggestions - Error checking - + When adding images, reference them from `/assets` (not `/public/assets`). Example: ``` ![Example Image](/assets/user-manual/image.png) diff --git a/content/docs/contribute/index.mdx b/content/docs/contribute/index.mdx index 2585eac..de06764 100644 --- a/content/docs/contribute/index.mdx +++ b/content/docs/contribute/index.mdx @@ -34,23 +34,25 @@ Please follow the appropriate guide based on the repository you want to contribu ### Reporting Bugs -If you find a bug, please open an issue and describe the problem in detail. Include steps to reproduce the bug, the expected behavior, and any relevant information about your environment. Please verify that the bug has not been reported already. +If you find a bug, please open an issue on the correct repository's GitHub and describe the problem in detail. Include steps to reproduce the bug, the expected behavior, and any relevant information about your environment. Please verify that the bug has not been reported already. - -Open the issue in it's corresponding GitHub repository: + -- [Desktop Browser App](https://github.com/zen-browser/desktop/issues) -- [Zen's Custom Mods](https://github.com/zen-browser/theme-store) -- [Zen's Homepage Website](https://github.com/zen-browser/www) -- [This documentation Website](https://github.com/zen-browser/docs) +- [Zen Browser for Windows, Linux, and macOS (Main Repository)](https://github.com/zen-browser/desktop/issues) +- [Zen Browser Mods/Theme Store](https://github.com/zen-browser/theme-store/issues) +- [Zen Browser Website](https://github.com/zen-browser/www/issues) +- [Zen Browser Documentation](https://github.com/zen-browser/docs/issues) ### Suggesting Features -![Discuss](/assets/contribute/discuss.png) +![GitHub Discussions](/assets/contribute/discuss.png) -We welcome suggestions for new features or improvements to existing ones. To suggest a feature, please start a new Github discussion in the Ideas category. -_Use the correct Github Repository based on the list above_ +We welcome suggestions for new features or improvements. Have an idea to make Zen better? Create a [new GitHub Discussion in the main browser repository](https://github.com/zen-browser/desktop/discussions), and label it under the Ideas category. + + +- [https://discord.gg/zen-browser](https://discord.gg/zen-browser) + --- diff --git a/content/docs/contribute/www.mdx b/content/docs/contribute/www.mdx index 07fea92..2725592 100644 --- a/content/docs/contribute/www.mdx +++ b/content/docs/contribute/www.mdx @@ -63,9 +63,9 @@ This command will start a local server and open the homepage in your default web You can now start making changes to the homepage. The project structure is as follows: -- **src/**: Contains the source code for the homepage. -- **public/**: Contains static files like images and HTML templates. -- **package.json**: Lists the project's dependencies and scripts. +- `src/`: Contains the source code for the homepage. +- `public/`: Contains static files like images and HTML templates. +- `package.json`: Lists the project's dependencies and scripts. Feel free to explore and modify the files to implement new features or fix bugs. diff --git a/content/docs/faq.mdx b/content/docs/faq.mdx index 728465f..27422f4 100644 --- a/content/docs/faq.mdx +++ b/content/docs/faq.mdx @@ -1,18 +1,18 @@ --- -title: FAQ +title: FAQs icon: CircleHelp --- import KeyboardShortcut from '@/components/KeyboardShortcut'; import { Callout } from 'fumadocs-ui/components/callout'; import { InlineTOC } from 'fumadocs-ui/components/inline-toc'; -Welcome to the Zen Browser FAQ section! Here, you'll find answers to common questions and helpful tips to enhance your experience with Zen Browser. If your question isn't covered here, feel free to explore our community forums [r/zen_browser](https://www.reddit.com/r/zen_browser) or reach out to the support team. +Welcome to the FAQs section! Here, you'll find answers to common questions and helpful tips to enhance your experience with Zen Browser. If your question isn't covered here, feel free to explore our subreddit, [r/zen_browser](https://www.reddit.com/r/zen_browser), or reach out to the support team. ## How can I use horizontal tabs? -Zen Browser will not support horizontal tabs in the near future. The decision to focus on **Vertical Tabs** is a core design choice, with the entire Zen Browser experience built around this concept. This approach is intended to maximize screen space and improve navigation, making vertical tabs an essential part of Zen's philosophy. +Zen Browser will not support horizontal tabs in the near future. The decision to focus on **Vertical Tabs** is a core design choice; the entire Zen Browser experience is built around them. Vertical tabs are intended to maximize screen space and improve navigation, and they are an essential part of Zen's philosophy. ## Will there be mobile version for Zen Browser? @@ -21,7 +21,7 @@ At the moment, our team does not have the time or resources to develop Android o ## Why can't Zen Browser play DRM-protected content? - This only affects Microsoft Windows and MacOS + This issue only affects Microsoft Windows and MacOS. @@ -33,7 +33,7 @@ Zen Browser currently lacks DRM support, as it does not yet have a Widevine lice We’re in the process of obtaining a Widevine license and are currently awaiting approval from Google. If you’d like to help speed things along, you can express your support by contacting Google directly through their [Widevine contact form](https://www.widevine.com/contact). - + Due to the lack of DRM support, you will not be able to stream content from the following services in Zen Browser: - **HBO Max** @@ -43,7 +43,7 @@ We’re in the process of obtaining a Widevine license and are currently awaitin - **Amazon Prime Video** - **Apple Music** - **Google Play Movies & TV** - - **And possible other services that use DRM not listed here** + - **Other services that require DRM** @@ -53,11 +53,11 @@ We’re in the process of obtaining a Widevine license and are currently awaitin ## How do I know Zen is safe? -Zen Browser is designed with a focus on security and privacy. Additionally, the browser's codebase is derived from Firefox, a well-known and trusted open-source project. Users can verify the safety of the browser by reviewing the source code available on [GitHub](https://github.com/zen-browser/desktop). Regular updates and community engagement also contribute to its security. +Zen Browser is designed with a focus on security and privacy. The browser's codebase is derived from Firefox, a well-known and trusted open-source project. Additionally, users can verify the safety of Zen by reviewing its source code, whcih is available on [GitHub](https://github.com/zen-browser/desktop). Regular updates and community engagement also contribute to its security. ## How can I support Zen? -If you'd like to support the development of Zen Browser, you can do so through their official donation platforms. Contributions help the small team continue improving the browser and adding new features. You can support Zen Browser in the following ways: +If you'd like to support the development of Zen Browser, you can do so through its official donation platforms. Contributions help Zen's small team continue improving the browser and adding new features. You can support Zen Browser in the following ways: - **Patreon**: Visit [https://www.patreon.com/zen_browser](https://www.patreon.com/zen_browser) to make recurring donations and gain access to updates and possible rewards. - **Ko-fi**: You can also support Zen Browser with one-time donations via [https://ko-fi.com/zen_browser](https://ko-fi.com/zen_browser). @@ -70,73 +70,75 @@ Your support helps the team maintain and enhance Zen Browser for everyone! Use shortcuts to perform Split View actions faster! -1. Select multiple tabs by left-clicking them while holding the key, or left-click 2 tabs while holding the key to select all tabs in between -2. Right click a tab, and select `Split x Tabs` -3. Change the view mode by pressing the `[|]` button in the top address bar +1. **Select multiple tabs by left-clicking them while holding the key, or left-click 2 tabs while holding the key to select all tabs in between.** +2. **Right click a tab, and select `Split x Tabs`.** +3. **Change the view mode by pressing the `[|]` button in the top address bar.** ## How to switch tabs by scrolling? You can enable this feature by changing a setting in the browser's configuration. Here's how: -1. Open the `about:config` page. This page contains advanced settings for the browser. -2. Search for `toolkit.tabbox.switchByScrolling` -3. Toggle the setting to `true` by double-clicking on it +1. **Type `about:config` into your address bar.** +2. **Search for `toolkit.tabbox.switchByScrolling`.** +3. **Double-click the flag in order to toggle it to `true`.** Once this setting is enabled, you can hover your mouse over the tab bar and use your mouse wheel to scroll through the tabs, making it easier to navigate between them. -## Where do report problems and bugs? +## Where do I report problems and bugs? -New features are not bugs. Please see [Where do I recommend features?](#where-do-i-recommend-features) below + Lack of a certain feature is not a bug. Please see the [Where do I recommend features?](#where-do-i-recommend-features) section below. -If you want report an issue or a bug with the browser, you can do so on the browser's GitHub page. Before submitting your request, it's mandatory to check if the issue has already been reported. You can do this by searching through existing issues on the [GitHub issues page](https://github.com/zen-browser/desktop/issues). +If you want report an issue or a bug with Zen, you can do so by creating a new GitHub Issue [here](https://github.com/zen-browser/desktop/issues). Before submitting your request, you must check if the issue has already been reported. You can do so by searching through existing issues on the [GitHub Issues page](https://github.com/zen-browser/desktop/issues). -Keep in mind that the Zen Browser team is currently very small, so it might take some time for your request to be reviewed and addressed. The team is dedicated to improving the browser, but with limited resources, they prioritize the most critical and popular requests. Your patience and thoroughness in reporting can help make Zen Browser better for everyone. +Keep in mind that the Zen Browser team is currently very small, so it might take some time for your request to be reviewed and addressed. The Zen team is dedicated to improving the browser, but due to limited resources, the team prioritizes the most critical and popular requests. Your patience and thoroughness in reporting can help make Zen Browser better for everyone. ## Where do I recommend features? -If you want to recommend features or new ideas for Zen, you can do so on the GitHub discussion page. Before submitting your request, it's mandatory to check if the issue or feature has already been reported. You can do this by searching through existing issues on the [GitHub discussions page](https://github.com/zen-browser/desktop/discussions). +If you want to recommend new features or ideas for Zen, you can do so on [Zen's GitHub Discussions page](https://github.com/zen-browser/desktop/discussions). Before submitting your request, you must check if the idea or feature has already been requested. You can do so by searching through existing issues on the [GitHub Discussions page](https://github.com/zen-browser/desktop/discussions). -It may also be a good idea to see the [Zen Browser Subreddit](https://www.reddit.com/r/zen_browser/) where there are active discussions of development. Please remember again that the team is small and always in need of help so if you can't find a way to develop the new feature yourself, it will only come once someone is available and has enough interest to build it. Careful descriptions and explanation of the point of the feature may help. +You may also be interested in exploring the [Zen Browser subreddit](https://www.reddit.com/r/zen_browser/), where there are active discussions regarding Zen's development. Please remember that the Zen team is small and always in need of help, so unless you can develop the new feature yourself, it will only come once someone is available and has enough interest to build it. Careful descriptions and explanation of the point of the feature may help. ## How can I sync my data across multiple devices? Zen Browser integrates with Firefox Sync, allowing you to sync your addons, bookmarks, history, passwords, and other browser data across multiple devices. To enable Firefox Sync in Zen Browser: -1. **Open the Zen Browser Settings** -2. **Navigate to the "Sync" tab** -3. **Sign in with your Mozilla Account.** (If you don't have an account, you'll need to create one) -4. **Select what data you wish to sync** +1. **Open the Zen Browser Settings.** +2. **Navigate to the "Sync" tab.** +3. **Sign in with your Mozilla Account.** (If you don't have an account, you'll need to create one.) +4. **Select what data you wish to sync.** After signing in and selecting your preferences, your data will be synced across all devices where you are signed in with the same Mozilla account. ## How do I use RTX Video Super Resolution? -To enable Zen Browser to use the feature +To allow Zen Browser to use the feature: -1. **Open 'about:config'** -2. **Search for 'gfx.webrender.dcomp-video-hw-overlay-win-force-enabled'** -3. **Double click the flag to toggle it to 'true'** -4. **Restart the browser** +1. **Type `about:config` into your address bar.** +2. **Search for `gfx.webrender.dcomp-video-hw-overlay-win-force-enabled`.** +3. **Double click the flag to toggle it to `true`.** +4. **Restart your browser.** -Refer to [Nvidia's RTX Video FAQ](https://nvidia.custhelp.com/app/answers/detail/a_id/5448/~/rtx-video-faq) for additional information. +Refer to [NVIDIA's RTX Video FAQ](https://nvidia.custhelp.com/app/answers/detail/a_id/5448/~/rtx-video-faq) for additional information. -## Transparency bug +## My websites are oddly transparent, what do I do? -Some users encounter the bug where websites are partially transparent, to resolve it follow bellow: +Some users encounter a bug where websites are partially transparent. To resolve the issue: -1. **Url `about:config`** -2. Search for `browser.tabs.allow_transparent_browser` -3. Set the flag to `false` -4. **Restart the browser** +1. **Type `about:config` into your address bar.** +2. **Search for `browser.tabs.allow_transparent_browser`.** +3. **Set the flag to `false`.** +4. **Restart your browser.** -## Themes/Mods broken +## My Zen themes/Mods are broken, what do I do? -Some users may encounter a bug where themes are broken, to resolve it to follow the steps below: +Some users encounter a bug where themes are broken. To resolve the issue: -1. Go to your profiles folder (Linux: `~/.zen/` or Flatpak: `~/.var/app/app.zen_browser.zen/zen/`, Windows: `%APPDATA%/zen/Profiles`) -2. Go into the folder of the profile you are using (e.g. with the (release) suffix) -3. Delete (or edit) the zen-themes.json file and restart the browser. +1. Navigate to your profiles directory (Linux: `~/.zen/`, Flatpak: `~/.var/app/app.zen_browser.zen/zen/`, Windows: `%APPDATA%/zen/Profiles`). +2. Open the folder of the profile you are currently using (usually, the one with the (release) suffix). +3. Delete (or edit) the `zen-themes.json` file and restart the browser. -Its recommended to backup the file before updating it manually. By editing you could break the browser + + We recommend backing up the `zen-themes.json` file before deleting or editing it; by changing the file, you risk breaking Zen. + \ No newline at end of file diff --git a/content/docs/guides/1password.mdx b/content/docs/guides/1password.mdx index e2170f1..6f29814 100644 --- a/content/docs/guides/1password.mdx +++ b/content/docs/guides/1password.mdx @@ -3,27 +3,27 @@ title: 1Password Integration description: How to integrate 1Password Desktop App with Zen Browser --- -This Guide is designed to help you integrate [1Password Desktop App](https://1password.com/downloads) with Zen Browser, for a more **straight forward workflow** when accessing your credentials using this password manager browser extension. +This guide is designed to help you integrate [1Password Desktop App](https://1password.com/downloads) with Zen Browser for a more **straightforward workflow** when accessing your credentials using this password manager browser extension. -This guide only applies for **Linux** and **MacOS** users. +This guide only applies to **Linux** and **macOS** users. -**Windows** users can still use the Browser Extension without integration with the Desktop App +**Windows** users should use the 1Password browser extension without integration with the desktop app. -See: [Adding another trusted browser - 1Password](https://support.1password.com/1password-browser-connection-security/#adding-another-trusted-browser) +See this page for more info: [Adding another trusted browser - 1Password](https://support.1password.com/1password-browser-connection-security/#adding-another-trusted-browser). -1Password browser integrations follows a [list of well-known/trusted browser](https://support.1password.com/1password-browser-connection-security/), with this integration account information and encryption keys are transferred using this connection to allow the 1Password app and browser extension to share your vaults and lock state and allowing you to unlock your Browser Extension Vault with [bio-metric](https://en.wikipedia.org/wiki/Biometrics) data. +1Password browser integrations rely on a [list of recognized and trusted browsers](https://support.1password.com/1password-browser-connection-security/). Through this integration, account information and encryption keys are securely transferred, enabling the 1Password app and browser extension to share vaults, sync lock status, and unlock the Browser Extension Vault using biometric authentication. -Since Zen Browser is still under development and [under the usage threshold](https://1password.community/discussion/comment/719323#Comment_719341) 1Password takes in consideration Zen Browser is not within this list causing the 1Password Browser integration to fail. +Since Zen Browser is still under development and [under the usage threshold](https://1password.community/discussion/comment/719323#Comment_719341), it isn’t included in this list. As a result, the 1Password browser integration does not work with Zen Browser. ## Workarounds -That being said, there are workaround methods to add Zen Browser to this _Trusted Browsers_ list for **Linux** and **MacOS**. +That being said, there are workaround methods to add Zen Browser to the _Trusted Browsers_ list for **Linux** and **MacOS**. ### Linux -You can create a _Custom Allowed Browsers_ file that 1Password will use to allow Zen Browser -- or other non-officially supported browser-- to integrate with 1Password's desktop app. +You can create a _Custom Allowed Browsers_ file that 1Password will use to allow Zen Browser -- or other non-officially supported browsers -- to integrate with 1Password's desktop app. #### 1. Create 1Password's config directory @@ -45,7 +45,7 @@ echo "zen-bin" | sudo tee -a /etc/1password/custom_allowed_browsers --- -Special thanks to [u/xmansyx](https://www.reddit.com/user/xmansyx/) and [u/feelspeaceman](https://www.reddit.com/user/feelspeaceman/) +Special thanks to [u/xmansyx](https://www.reddit.com/user/xmansyx/) and [u/feelspeaceman](https://www.reddit.com/user/feelspeaceman/)! Sources: @@ -54,9 +54,9 @@ Sources: --- -### MacOS +### macOS -In MacOS you can use the Graphical Interface of the Desktop app to add Zen Browser to the trusted browsers list. +In macOS, you can manually add Zen Browser to the trusted browsers list in the 1Password app. 1. Go into the 1Password desktop app and open Settings. diff --git a/content/docs/guides/generic-optimized.mdx b/content/docs/guides/generic-optimized.mdx index 2e41729..de24993 100644 --- a/content/docs/guides/generic-optimized.mdx +++ b/content/docs/guides/generic-optimized.mdx @@ -1,6 +1,6 @@ --- -title: Optimized builds -description: Why have optimized builds been removed? +title: Optimized Builds +description: Why were optimized builds removed? --- For Windows and Linux, Zen Browser used to have the option to download optimized builds. These builds utilized AVX2 instructions to improve performance. These builds have been removed because of the following reasons: @@ -11,6 +11,8 @@ For Windows and Linux, Zen Browser used to have the option to download optimized In conclusion, having optimized builds is not really worth it, especially if we want to have PGO & LTO. -P.S. all optimized builds will be automatically updated to generic starting from version `1.0.2-b.4`. + + All optimized builds will be automatically updated to generic builds, from version `1.0.2-b.4` onward. + -View original [here](https://github.com/zen-browser/desktop/wiki/Why-have-optimized-builds-been-removed%3F) +View the original announcement [here](https://github.com/zen-browser/desktop/wiki/Why-have-optimized-builds-been-removed%3F). diff --git a/content/docs/guides/live-editing.mdx b/content/docs/guides/live-editing.mdx index bae4f0f..ac92d27 100644 --- a/content/docs/guides/live-editing.mdx +++ b/content/docs/guides/live-editing.mdx @@ -1,17 +1,17 @@ --- -title: Live Editing Zen Theme +title: Live Editing Zen description: Learn how to live edit the appearance of Zen Browser by editing the userChrome.css file. --- import KeyboardShortcut from '@/components/KeyboardShortcut'; import { Callout } from 'fumadocs-ui/components/callout'; -This Guide will help you customize the appearance of Zen Browser by live editing the `userChrome.css` file. Follow the steps below to start customizing your browser's theme. +This guide will help you customize the appearance of Zen Browser by live editing the `userChrome.css` file. Follow the steps below to start customizing your browser's theme. ## Step 1: Access the Profile Folder - On the Flatpak version of Zen, the profile folder will be located at `~/.var/app/app.zen_browser.zen/.zen`. + On the Flatpak version of Zen, the profile folder is located at `~/.var/app/app.zen_browser.zen/.zen`. 1. Open Zen Browser. @@ -28,7 +28,7 @@ This Guide will help you customize the appearance of Zen Browser by live editing ## Step 3: Open Style Editor in Zen Browser - After Zen Browser version `1.0.0-a.31` the Browser Developer Tools is disabled by default for security. + After Zen Browser version `1.0.0-a.31`, the Browser Developer Tools is disabled by default for security. 1. Open the `about:config` page. This page contains advanced settings for the browser. 2. Search for `devtools.debugger.remote-enabled` and toggle it to `true`. diff --git a/content/docs/guides/manage-profiles.mdx b/content/docs/guides/manage-profiles.mdx index 04d477b..1c00e46 100644 --- a/content/docs/guides/manage-profiles.mdx +++ b/content/docs/guides/manage-profiles.mdx @@ -5,7 +5,7 @@ description: Learn how to manage Firefox profiles effectively, preserving key el import { Callout } from 'fumadocs-ui/components/callout'; -This Guide will give you a comprehensive understanding of Firefox profiles, helping you manage them effectively even in the most challenging situations. By following this guide, you'll learn how to preserve key elements of your browsing experience, including bookmarks, history, passwords, and more. +This guide will give you a comprehensive understanding of Firefox profiles, helping you manage them effectively even in the most challenging situations. By following this guide, you'll learn how to preserve key elements of your browsing experience, including bookmarks, history, passwords, and more. ## Goal @@ -23,7 +23,7 @@ This guide will help you: ### 1. Open Your Current Profile Folder - + This step is crucial to avoid corruption, as Firefox continuously reads and writes data while running. @@ -32,25 +32,25 @@ This guide will help you: ### 2. Copy Essential Files - - - **storage folder**: If you want to keep add-on customizations (this may not work 100% of the time). - - **chrome folder**: If you want to retain your interface customizations. + + - **`storage` folder**: If you want to keep add-on customizations (this may not work 100% of the time). + - **`chrome` folder**: If you want to retain your interface customizations. After turning off Firefox, copy the following files from your profile folder: -- **places.sqlite**: Contains bookmarks and history. -- **cookies.sqlite**: Stores login sessions. -- **cert9.db + key4.db + logins.json**: Holds your saved passwords. -- **extension-preferences.json + extensions.json + extension-settings.json + extensions folder**: These files keep track of your installed add-ons (but not their custom settings). -- **search.json.mozlz4**: Stores your search engine preferences. -- **sessionCheckpoints.json + sessionstore.jsonlz4**: Saves your currently open tabs. -- **prefs.js**: Contains your `about:config` settings. +- `places.sqlite`: Contains bookmarks and history. +- `cookies.sqlite`: Stores login sessions. +- `cert9.db`, `key4.db`, `logins.json`: Holds your saved passwords. +- `extension-preferences.json`, `extensions.json`, `extension-settings.json`, `extensions` folder: These files keep track of your installed add-ons (but not their custom settings). +- `search.json.mozlz4`: Stores your search engine preferences. +- `sessionCheckpoints.json`, `sessionstore.jsonlz4`: Saves your currently open tabs. +- `prefs.js`: Contains your `about:config` settings. ### 3. Create and Set Up a New Profile - - If Firefox opens with an incompatibility error after pasting the files, go to the new profile folder and move the `compatibility.ini` file somewhere else. + + If Firefox opens with an incompatibility error after pasting the files, go to the folder with your new profile and move the `compatibility.ini` file somewhere else. 1. Go to `about:profiles` in Firefox. diff --git a/content/docs/index.mdx b/content/docs/index.mdx index ff4f199..875a555 100644 --- a/content/docs/index.mdx +++ b/content/docs/index.mdx @@ -15,55 +15,55 @@ import { Hammer } from 'lucide-react'; -Welcome to **Zen Browser's Documentation!** Here, you'll find everything you need to get the most out of your browsing experience. Dive in to explore how Zen can make your browsing more secure, private, and efficient. +Welcome to **Zen Browser's documentation**! Here, you'll find everything you need to get the most out of your browsing experience. Learn how Zen can make your browsing more secure, private, and efficient. } title="User Manual" href="/user-manual" - description="Complete user guide and features" + description="Explore the Zen Browser experience" /> } title="CSS Live Editing" href="/guides/live-editing" - description="Live CSS editing for customizing the browser" + description="Customize Zen with live CSS editing" /> } - title="Build the Browser" + title="Build Zen" href="/contribute/desktop" - description="Build the browser from source" + description="Build Zen Browser from the source code" /> } title="Mods Registry" href="/themes-store/themes-marketplace" - description="Custom themes and modifications" + description="Try custom themes and modifications" /> } - title="FAQ" + title="FAQs" href="/faq" - description="Frequently asked questions" + description="View frequently asked questions" /> } title="Security" href="/security" - description="Security features and protocols" + description="Learn about Zen's security features and protocols" /> } title="Code of Conduct" href="/contribute/code-of-conduct" - description="Community guidelines" + description="Read the community guidelines" /> } title="Contribute" href="/contribute" - description="How to contribute to the project" + description="Contribute to the project" /> diff --git a/content/docs/security.mdx b/content/docs/security.mdx index 5e0293e..3fa8b77 100644 --- a/content/docs/security.mdx +++ b/content/docs/security.mdx @@ -5,24 +5,24 @@ icon: ShieldCheck --- import { Callout } from 'fumadocs-ui/components/callout'; - -All passwords, cookies, and cache in Zen Browser are **managed by Firefox**. This means your saved passwords are **automatically encrypted**, providing an extra layer of security to keep your login credentials safe. Cookies and cache are also handled according to Firefox's strict privacy policies, ensuring your data is stored securely and only accessible to you. -For more information visit [Firefox Privacy and Security](https://support.mozilla.org/es/products/firefox/privacy-and-security) + +All passwords, cookies, and cache files in Zen Browser are **managed by Firefox**. This means your saved passwords are **automatically encrypted**, providing an extra layer of security to keep your login credentials safe. Cookies and cache are also handled according to Firefox's strict privacy policies, ensuring your data is stored securely and only accessible to you. +For more information, explore [Firefox's privacy and security articles](https://support.mozilla.org/products/firefox/privacy-and-security). ## Adjusting Security Settings Zen Browser lets you customize privacy and security settings to improve your browsing safety. If you want to adjust or change these settings: -1. Click the `menu button` and select `Settings`. +1. Click the menu button and select `Settings`. 2. On the sidebar, go to the `Privacy & Security` section. --- -## Security +## Integrated Protection - -Zen Browser is built on the **latest version of Firefox**, one of the most secure browsers available today. This means you benefit from all of Firefox's security patches and updates as soon as they are released, keeping you safe from known vulnerabilities. + + Zen Browser is built on the **latest version of Firefox**, one of the most secure browsers available today. This means you benefit from all of Firefox's security patches and updates as soon as they are released, keeping you safe from known vulnerabilities. ### 1. Staying Up-to-Date with Firefox @@ -47,13 +47,13 @@ Zen Browser uses **OCSP (Online Certificate Status Protocol)** to check the vali You can enable HTTPS-Only Mode in **all windows** or **private windows only**. -For more information visit [HTTPS-Only Mode in Firefox](https://support.mozilla.org/en-US/kb/https-only-prefs) +For more information, visit [HTTPS-Only Mode in Firefox](https://support.mozilla.org/en-US/kb/https-only-prefs). ### 4. Deceptive Content and Dangerous Software Protection Zen Browser helps protect you from **phishing, malware, and fraudulent websites**. It uses URL filters and real-time checks to block harmful content, making your browsing experience safer. -To learn more, visit [Block deceptive content and dangerous downloads in Firefox](https://support.mozilla.org/en-US/kb/block-deceptive-content-and-dangerous-downloads-firefox) +To learn more, visit [Block deceptive content and dangerous downloads in Firefox](https://support.mozilla.org/en-US/kb/block-deceptive-content-and-dangerous-downloads-firefox). ### 5. SSL – Treat Unsafe Negotiation as Broken by Default @@ -61,7 +61,7 @@ Zen Browser treats insecure SSL connections (those that don't meet modern securi --- -## Privacy settings +## Privacy Settings ### 1. Tracking Protection @@ -71,9 +71,9 @@ To protect your privacy, Zen Browser includes **tracking protection**. This feat You can choose from three levels of Tracking Protection: **Standard**, **Strict**, or **Custom**. -### 2. DNS over HTTPS +### 2. DNS Over HTTPS -Zen Browser allows the users to enable DNS over HTTPS, which **sends your request for a domain name through an encrypted connection**, providing a secure DNS and making it harder for others to see which website you’re about to access. +Zen Browser allows users to enable DNS over HTTPS, which **sends your request for a domain name through an encrypted connection**, providing a secure DNS and making it harder for others to see which website you’re about to access. You can choose from three protection levels: **Default Protection**, **Increased Protection**, or **Max Protection**. @@ -81,4 +81,4 @@ You can choose from three protection levels: **Default Protection**, **Increased --- -These security features work behind the scenes to provide a safe and private browsing experience. With Zen Browser, you can browse with confidence knowing that your security is always a top priority. +These security features work behind the scenes to provide a safe and private browsing experience. With Zen Browser, you can browse with confidence, knowing that your security is always a top priority. diff --git a/content/docs/themes-store/themes-marketplace-submission-guidelines.mdx b/content/docs/themes-store/themes-marketplace-submission-guidelines.mdx index 3a8f8d8..3147158 100644 --- a/content/docs/themes-store/themes-marketplace-submission-guidelines.mdx +++ b/content/docs/themes-store/themes-marketplace-submission-guidelines.mdx @@ -4,9 +4,9 @@ title: Submission Guidelines import { Callout } from 'fumadocs-ui/components/callout'; -If you are a [mod developer] and would like to submit your mod, please follow these guidelines: +If you are a developer and would like to submit a Zen Mod, please follow these guidelines: -1. **Mod requirements**: +1. **Mod Requirements**: - Your mod must be compatible with Zen Browser. - Your mod must be open-source. diff --git a/content/docs/themes-store/themes-marketplace.mdx b/content/docs/themes-store/themes-marketplace.mdx index f3dce81..e685cce 100644 --- a/content/docs/themes-store/themes-marketplace.mdx +++ b/content/docs/themes-store/themes-marketplace.mdx @@ -4,12 +4,12 @@ title: Information The Mods Registry is a place where you can find and install mods for Zen Browser. -## How to install a mod +## Installing Mods 1. Open Zen Browser. 2. Click on the mod you would like to install on the [Mods Registry](https://www.zen-browser.app/mods). 3. Click on the "Install" button. -## For mod developers +## For Developers -If you are a mod developer and would like to submit your mod, please follow the instructions on the [Submission Guidelines](./themes-marketplace-submission-guidelines.mdx) page. +If you are a developer and would like to submit a Zen Mod, please follow the instructions on the [Submission Guidelines](./themes-marketplace-submission-guidelines.mdx) page. \ No newline at end of file