From 6e0fbeecd02fa3b1d4085c113f40ea29c8b93ed9 Mon Sep 17 00:00:00 2001
From: Daniel Gray <dngray@privacyguides.org>
Date: Thu, 16 Feb 2023 04:35:11 +0000
Subject: [PATCH] Add Vanadium guide (#1978)

---
 docs/assets/img/browsers/vanadium-dark.svg |  2 ++
 docs/assets/img/browsers/vanadium.svg      |  2 ++
 docs/mobile-browsers.en.md                 | 20 ++++++++++++++++++++
 3 files changed, 24 insertions(+)
 create mode 100644 docs/assets/img/browsers/vanadium-dark.svg
 create mode 100644 docs/assets/img/browsers/vanadium.svg

diff --git a/docs/assets/img/browsers/vanadium-dark.svg b/docs/assets/img/browsers/vanadium-dark.svg
new file mode 100644
index 0000000000..1611ae3c9b
--- /dev/null
+++ b/docs/assets/img/browsers/vanadium-dark.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="128" height="128" version="1.1" viewBox="0 0 33.867 33.867" xmlns="http://www.w3.org/2000/svg"><defs><clipPath id="clip_path_0"><path d="m27 27h36v36h-36z"/></clipPath></defs><g transform="matrix(.94074 0 0 .94074 -25.4 -25.416)" fill="#fff"><path d="m35.773 42.559c0.5437-2.0321 1.7426-3.8281 3.4109-5.1095s3.7127-1.9767 5.8163-1.978h15.231c-1.533-2.4512-3.635-4.4961-6.1274-5.961-2.4925-1.465-5.3017-2.3066-8.189-2.4535-2.8874-0.1469-5.7675 0.4054-8.3957 1.6098-2.6283 1.2044-4.927 3.0255-6.7008 5.3085z" clip-path="url(#clip_path_0)"/><path d="m47.472 54.262c-2.0311 0.5535-4.1885 0.4168-6.1336-0.3887-1.945-0.8054-3.5675-2.234-4.6127-4.0613l-0.0091 0.0051-7.6218-13.201c-1.3547 2.5548-2.073 5.3987-2.094 8.2903-0.021 2.8917 0.6559 5.7457 1.9734 8.3199 1.3174 2.5742 3.2365 4.7925 5.5943 6.4667s5.0847 2.7549 7.9493 3.1502z"/><path d="m51.772 38.284c1.4859 1.4875 2.4387 3.4242 2.7103 5.5091s-0.1532 4.2011-1.2084 6.0197l0.0105 6e-3 -7.6099 13.181c2.8881-0.1031 5.7087-0.9014 8.2225-2.3271 2.5137-1.4257 4.6464-3.4368 6.2172-5.8626 1.5707-2.4258 2.5331-5.1947 2.8055-8.0717 0.2724-2.8771-0.1533-5.7774-1.2409-8.4548z"/><path d="m45 51.784c3.7279 0 6.75-3.0221 6.75-6.75s-3.0221-6.75-6.75-6.75-6.75 3.0221-6.75 6.75 3.0221 6.75 6.75 6.75z"/></g></svg>
diff --git a/docs/assets/img/browsers/vanadium.svg b/docs/assets/img/browsers/vanadium.svg
new file mode 100644
index 0000000000..6f4197339e
--- /dev/null
+++ b/docs/assets/img/browsers/vanadium.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="128" height="128" version="1.1" viewBox="0 0 33.867 33.867" xmlns="http://www.w3.org/2000/svg"><defs><clipPath id="clip_path_0"><path d="m27 27h36v36h-36z"/></clipPath></defs><g transform="matrix(.94074 0 0 .94074 -25.4 -25.416)"><path d="m35.773 42.559c0.5437-2.0321 1.7426-3.8281 3.4109-5.1095s3.7127-1.9767 5.8163-1.978h15.231c-1.533-2.4512-3.635-4.4961-6.1274-5.961-2.4925-1.465-5.3017-2.3066-8.189-2.4535-2.8874-0.1469-5.7675 0.4054-8.3957 1.6098-2.6283 1.2044-4.927 3.0255-6.7008 5.3085z" clip-path="url(#clip_path_0)"/><path d="m47.472 54.262c-2.0311 0.5535-4.1885 0.4168-6.1336-0.3887-1.945-0.8054-3.5675-2.234-4.6127-4.0613l-0.0091 0.0051-7.6218-13.201c-1.3547 2.5548-2.073 5.3987-2.094 8.2903-0.021 2.8917 0.6559 5.7457 1.9734 8.3199 1.3174 2.5742 3.2365 4.7925 5.5943 6.4667s5.0847 2.7549 7.9493 3.1502z"/><path d="m51.772 38.284c1.4859 1.4875 2.4387 3.4242 2.7103 5.5091s-0.1532 4.2011-1.2084 6.0197l0.0105 6e-3 -7.6099 13.181c2.8881-0.1031 5.7087-0.9014 8.2225-2.3271 2.5137-1.4257 4.6464-3.4368 6.2172-5.8626 1.5707-2.4258 2.5331-5.1947 2.8055-8.0717 0.2724-2.8771-0.1533-5.7774-1.2409-8.4548z"/><path d="m45 51.784c3.7279 0 6.75-3.0221 6.75-6.75s-3.0221-6.75-6.75-6.75-6.75 3.0221-6.75 6.75 3.0221 6.75 6.75 6.75z"/></g></svg>
diff --git a/docs/mobile-browsers.en.md b/docs/mobile-browsers.en.md
index e5bc37062e..e1b21a01bf 100644
--- a/docs/mobile-browsers.en.md
+++ b/docs/mobile-browsers.en.md
@@ -86,6 +86,26 @@ Shields' options can be downgraded on a per-site basis as needed, but by default
 
 [Brave Sync](https://support.brave.com/hc/en-us/articles/360059793111-Understanding-Brave-Sync) allows your browsing data (history, bookmarks, etc.) to be accessible on all your devices without requiring an account and protects it with E2EE.
 
+### Vanadium (GrapheneOS)
+
+!!! recommendation
+
+    ![Vanadium logo](assets/img/browsers/vanadium.svg#only-light){ align=right }
+    ![Vanadium logo](assets/img/browsers/vanadium-dark.svg#only-dark){ align=right }
+
+    **Vanadium** is the default browser that is included with [GrapheneOS](../android.md#grapheneos), it includes a number of [patches](https://github.com/GrapheneOS/Vanadium/tree/main/patches) which assist in improving security and privacy of WebView.
+
+    Vanadium is built upon the Chromium web browser project, so it should feel familiar and have minimal website compatibility issues.
+
+    [:octicons-home-16: Homepage](https://vanadium.app){ .md-button .md-button--primary }
+    [:octicons-code-16:](https://github.com/GrapheneOS/Vanadium){ .card-link title="Source Code" }
+
+#### Adblocking
+
+Currently the only way to block ads with Vanadium is to set a [DNS Resolver](../dns.md) that has this functionality. The option for that can be found in :material-dots-vertical: → **Settings** → **Privacy and security**. If you're using a VPN we suggest using your VPN provider's server.
+
+- [x] Select **Use secure DNS** > **Choose another provider**
+
 ## iOS
 
 On iOS, any app that can browse the web is [restricted](https://developer.apple.com/app-store/review/guidelines) to using an Apple-provided [WebKit framework](https://developer.apple.com/documentation/webkit), so there is little reason to use a third-party web browser.