Revamping the Android section (#390)

Co-authored-by: Daniel Nathan Gray <dng@disroot.org>
Signed-off-by: Freddy <freddy@decypher.pw>

.github/workflows/tests.yml

@@ -122,17 +122,12 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-htmlproofer-
             ${{ runner.os }}-htmlproofer
-      - name: Check All External Links (Informational, Soft-Fail)
+      - name: Check External Links (Informational, Soft-Fail)
         uses: chabad360/htmlproofer@v1.1
         with:
           directory: ${{ github.workspace }}/_site
           arguments: --assume-extension --external_only --internal-domains privacyguides.org,www.privacyguides.org --timeframe 30d --url-ignore '/https:\/\/developers\.cloudflare\.com\//,/https:\/\/github\.com\/privacyguides\/privacyguides\.org\/(edit|tree|blob)\/main/,/https:\/\/support\.(startmail|yubico)\.com\//'
         continue-on-error: true
-      - name: Check External Links (Only 4XX)
-        uses: chabad360/htmlproofer@v1.1
-        with:
-          directory: ${{ github.workspace }}/_site
-          arguments: --assume-extension --external_only --only_4xx --http-status-ignore 429 --internal-domains privacyguides.org,www.privacyguides.org --timeframe 30d --url-ignore '/https:\/\/developers\.cloudflare\.com\//,/https:\/\/github\.com\/privacyguides\/privacyguides\.org\/(edit|tree|blob)\/main/'
 
   https:
     name: "Require HTTPS Internal Images"

Gemfile

@@ -11,6 +11,7 @@ end
 # Jekyll 3.9.0 now requires this explicitly installed, apparently
 gem "kramdown-parser-gfm", "~> 1.1"
 gem "webrick", "~> 1.7"
+gem 'eventmachine', '1.3.0.dev.1', git: 'https://github.com/eventmachine/eventmachine', branch: 'master'
 
 # Windows does not include zoneinfo files, so bundle the tzinfo-data gem
 gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby]

Gemfile.lock

@@ -1,3 +1,10 @@
+GIT
+  remote: https://github.com/eventmachine/eventmachine
+  revision: 8e1d6b11fd8400593af035a7a0d203d24c10c9b0
+  branch: master
+  specs:
+    eventmachine (1.3.0.dev.1)
+
 GEM
   remote: https://rubygems.org/
   specs:
@@ -9,7 +16,6 @@ GEM
     em-websocket (0.5.2)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0.6.0)
-    eventmachine (1.2.7)
     ffi (1.15.4)
     forwardable-extended (2.6.0)
     http_parser.rb (0.6.0)
@@ -70,6 +76,7 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
+  eventmachine (= 1.3.0.dev.1)!
   jekyll (~> 4.2)
   jekyll-brotli (~> 2.3)
   jekyll-feed (~> 0.6)

_data/nav/1_home.yml

@@ -1,3 +0,0 @@
-type: link
-title: Home
-file: index.html

_data/nav/2_software.yml

@@ -6,7 +6,7 @@ items:
     icon: fad fa-browser
     file: _evergreen/browsers.html
   - type: link
-    title: Operating Systems
+    title: Operating Systems (Legacy)
     icon: fad fa-compact-disc
     file: legacy_pages/os.html
   - type: divider

_data/nav/3._operating_systems.yml

@@ -0,0 +1,7 @@
+type: dropdown
+title: Operating Systems
+items:
+  - type: link
+    title: Android
+    icon: fab fa-android
+    file: _evergreen/android.html

_data/operating-systems/android-applications/1_orbot.yml

@@ -0,0 +1,24 @@
+title: Orbot
+type: Recommendation
+logo: /assets/img/android/orbot.svg
+description: |
+  <strong>Orbot</strong> is a free proxy app that routes your connections through the Tor Network.
+
+  Orbot can proxy individual apps if they support SOCKS or HTTP proxying. It can also proxy all your network connections using the <a href="https://developer.android.com/reference/android/net/VpnService">VpnService</a> and can be used with the VPN killswitch (⚙️ Settings → Network & internet → VPN → ⚙️ → Block connections without VPN).
+
+  For resistance against traffic analysis attacks, consider enabling <em>Isolate Destination Address</em> ( ⁝ →Settings → Connectivity). This will use a completely different Tor Circuit (different middle relay and exit nodes) for every domain you connect to.
+
+  <h4>Notes</h4>
+  Orbot is often outdated on the Guardian Project's <a href="https://guardianproject.info/fdroid">F-Droid repository</a> and <a href="https://play.google.com/store/apps/details?id=org.torproject.android">Google Play</a> so consider downloading directly from the <a href="https://github.com/guardianproject/orbot">GitHub repository</a> instead.
+
+  All versions are signed using the same signature so they should be compatible with each other.
+website: 'https://guardianproject.info/apps/org.torproject.android'
+downloads:
+  - icon: fab fa-android
+    url: 'https://guardianproject.info/fdroid'
+  - icon: fab fa-google-play
+    url: 'https://play.google.com/store/apps/details?id=org.torproject.android'
+  - icon: fab fa-github
+    url: 'https://github.com/guardianproject/orbot'
+  - icon: fab fa-gitlab
+    url: 'https://gitlab.com/guardianproject/orbot'

_data/operating-systems/android-applications/2_shelter.yml

@@ -0,0 +1,20 @@
+title: Shelter
+type: Recommendation
+logo: /assets/img/android/shelter.svg
+description: |
+  <strong>Shelter</strong> is an app that helps you leverage the Android work profile to isolate other apps.
+
+  Shelter supports blocking contact search cross profiles and sharing files across profiles via the default file manager (<a href="https://source.android.com/devices/architecture/modular-system/documentsui">DocumentsUI</a>).
+
+  <h4>Notes</h4>
+  CalyxOS includes a device controller so we recommend using their built in work profile instead.
+website: 'https://gitea.angry.im/PeterCxy/Shelter'
+downloads:
+  - icon: fab fa-android
+    url: 'https://f-droid.org/en/packages/net.typeblog.shelter'
+  - icon: fab fa-google-play
+    url: 'https://play.google.com/store/apps/details?id=net.typeblog.shelter'
+  - icon: fab fa-github
+    url: 'https://github.com/PeterCxy/Shelter'
+  - icon: fab fa-git
+    url: 'https://gitea.angry.im/PeterCxy/Shelter'

_data/operating-systems/android-applications/3_auditor.yml

@@ -0,0 +1,26 @@
+title: Auditor
+type: Recommendation
+logo: /assets/img/android/auditor.svg
+description: |
+  <strong>Auditor</strong> is an app which leverages hardware security features to provide device integrity monitoring for <a href="https://attestation.app/about#device-support">supported devices</a>. It currently works with GrapheneOS and the stock operating system. It performs attestation and intrusion detection by:
+  <ul>
+    <li>Using a <a href="https://en.wikipedia.org/wiki/Trust_on_first_use">Trust On First Use (TOFU)</a> model between an <em>auditor</em> and <em>auditee</em>, the pair establish a private key in the <a href="https://source.android.com/security/keystore/">hardware-backed keystore</a> of the <em>Auditor</em>.</li>
+    <li>The <em>auditor</em> can either be another instance of the Auditor app or the <a href="https://attestation.app">Remote Attestation Service</a>.</li>
+    <li>The <em>auditor</em> records the current state and configuration of the <em>auditee</em>.</li>
+    <li>Should tampering with the operating system of the <em>auditee</em> after the pairing is complete, the auditor will be aware of the change in the device state and configurations.</li>
+    <li>The user will be alerted to the change.</li>
+  </ul>
+
+  No personally identifiable information is submitted to the attestation service. We do still recommend that you sign up with an anonymous account and enable remote attestation for continuous monitoring.
+
+  If your <a href="/threat-modeling/">threat model</a> requires complete anonymity you could consider using Orbot or a VPN to hide your IP address from the attestation service.
+
+  To make sure that your hardware and operating system is genuine, <a href="https://grapheneos.org/install/web#verifying-installation">perform local attestation</a> immediately after the device has been installed and prior to any internet connection.
+
+website: 'https://attestation.app'
+privacy_policy: 'https://attestation.app/privacy-policy'
+downloads:
+  - icon: fab fa-google-play
+    url: 'https://play.google.com/store/apps/details?id=app.attestation.auditor'
+  - icon: fab fa-github
+    url: 'https://github.com/GrapheneOS/Auditor'

_data/operating-systems/android/1_grapheneos.yml

@@ -0,0 +1,19 @@
+title: GrapheneOS
+type: Recommendation
+logo: /assets/img/android/grapheneos.svg
+description: |
+  <strong>GrapheneOS</strong> is the best choice when it comes to privacy and security.
+
+  GrapheneOS has a lot of security hardening and privacy improvements. It has a <a href="https://github.com/GrapheneOS/hardened_malloc">hardened memory allocator</a>, network and sensor permissions, and various other <a href="https://grapheneos.org/features">security features</a>. GrapheneOS also comes with full firmware updates and signed builds, so <a href="https://source.android.com/security/verifiedboot">verified boot</a> is fully supported.
+
+  Notably, GrapheneOS supports <a href="https://grapheneos.org/usage#sandboxed-play-services">Sandboxed Play Services</a>. Google Play Services can be run fully sandboxed like a regular user app and contained in a work profile or user <a href="/android/#android-security-privacy">profile</a> of your choice. This means that you can run apps dependant on Play Services, such as those that require push notifications using Google's <a href="https://firebase.google.com/docs/cloud-messaging/">Firebase Cloud Messaging</a> service. GrapheneOS allows you to take advantage of most <a href="https://en.wikipedia.org/wiki/Google_Play_Services">Google Play Services</a> whilst having full user control over their permissions and access.
+
+  Currently, only <a href="https://grapheneos.org/faq#device-support">Pixel phones</a> meet its hardware security requirement and are supported.
+
+  <h4>Notes</h4>
+  GrapheneOS's "extended support" devices do not have full security patches (firmware updates) due to the original equipment manufacturer (OEM) discontinuing support. These devices cannot be considered completely secure.
+website: 'https://grapheneos.org/'
+privacy_policy: 'https://grapheneos.org/faq#privacy-policy'
+downloads:
+  - icon: fab fa-github
+    url: 'https://github.com/GrapheneOS'

_data/operating-systems/android/2_calyxos.yml

@@ -0,0 +1,25 @@
+title: CalyxOS
+type: Recommendation
+logo: /assets/img/android/calyxos.svg
+description: |
+  <strong>CalyxOS</strong> is a decent alternative to GrapheneOS.
+
+  It has some privacy features on top of AOSP, such as the <a href="https://calyxos.org/docs/tech/datura-details"> Datura firewall</a>, <a href="https://signal.org">Signal</a> integration in the dialer app, and a built in panic button. CalyxOS also comes with firmware updates and signed builds, so <a href="https://source.android.com/security/verifiedboot">verified boot</a> is fully supported.
+
+  To accomodate users who need Google Play Services, CalyxOS optionally includes <a href="https://microg.org/">MicroG</a>. With MicroG, CalyxOS also bundles in the <a href="https://location.services.mozilla.com/">Mozilla</a> and <a href="https://github.com/n76/DejaVu">DejaVu</a> location services.
+
+  Currently, CalyxOS <a href="https://calyxos.org/docs/guide/device-support/">supports</a> Google Pixel phones and the Xiaomi Mi A2. For legacy devices, CalyxOS offers "extended support" for much longer than GrapheneOS, making it a good choice once GrapheneOS has dropped support.
+
+  <h4>Notes</h4>
+  CalyxOS's "extended support" does not have full security patches due to the original equipment manufacturer (OEM) discontinuing support, therefore they cannot be considered completely secure.
+
+  With the Xiaomi Mi A2, CalyxOS does not distribute the the latest firmware. Newer versions of the firmware prevented the device from performing verified boot.
+
+  The Daruta firewall can leak in some circumstances (see <a href="https://gitlab.com/CalyxOS/calyxos/-/issues/572">#572</a> and <a href="https://gitlab.com/CalyxOS/calyxos/-/issues/581">#581</a>).
+website: 'https://calyxos.org'
+privacy_policy: 'https://calyxinstitute.org/legal/privacy-policy'
+downloads:
+  - icon: fab fa-github
+    url: 'https://github.com/CalyxOS'
+  - icon: fab fa-gitlab
+    url: 'https://gitlab.com/calyxos'

_data/operating-systems/android/3_divestos.yml

@@ -0,0 +1,29 @@
+title: DivestOS
+type: Recommendation
+logo: /assets/img/android/divestos.svg
+description: |
+  <strong>DivestOS</strong> is a <a href="https://en.wikipedia.org/wiki/Fork_(software_development)#Forking_of_free_and_open-source_software">soft-fork</a> of <a href="https://lineageos.org/">LineageOS</a>.
+
+  DivestOS inherits many <a href="https://divestos.org/index.php?page=devices&base=LineageOS">supported devices</a> from LineageOS. It has signed builds, making it possible to have <a href="https://source.android.com/security/verifiedboot">verified boot</a> on some non-Pixel devices.
+
+  DivestOS has automated kernel vulnerability <a href="https://gitlab.com/divested-mobile/cve_checker">(CVE) patching</a>, fewer proprietary blobs, a custom <a href="https://divested.dev/index.php?page=dnsbl">hosts</a> file, along with bundled <a href="https://www.f-droid.org">F-Droid</a> as the app store. It also includes <a href="https://github.com/microg/UnifiedNlp">UnifedNlp</a> for network location and some hardening with <a href="https://gitlab.com/divested-mobile/mulch">Mulch Webview</a>. DivestOS also includes kernel patches from GrapheneOS and enables security features in <a href="https://github.com/Divested-Mobile/DivestOS-Build/blob/master/Scripts/Common/Functions.sh#L698">defconfig</a>.
+
+  DivestOS also inherits LineageOS's <a href="https://reddit.com/comments/c4a6f7">iptables</a> network access feature. You can deny network access to an individual application by pressing and holding on the app's icon. (App info → Data and Network → Uncheck "Network Access").
+
+  DivestOS 16.0 and 17.1 has GrapheneOS's <a href="https://github.com/GrapheneOS/hardened_malloc">hardened memory allocator</a>. There are plans to port this to DivestOS 18.1.
+
+  <h4>Notes</h4>
+  DivestOS firmware update <a href="https://gitlab.com/divested-mobile/firmware-empty/-/blob/master/STATUS">status</a> varies across the devices it supports. For Pixel phones, we still recommend using GrapheneOS or CalyxOS. For other supported devices, DivestOS is a good alternative.
+
+  Like CalyxOS's firewall, the network access toggle can also leak in <a href="https://gitlab.com/LineageOS/issues/android/-/issues/3228">some</a> situations.
+
+  Not all of the supported devices have <a href="https://source.android.com/security/verifiedboot">verified boot</a> and some perform it better than others.
+
+website: 'https://divestos.org'
+website_tor: 'http://divestoseb5nncsydt7zzf5hrfg44md4bxqjs5ifcv4t7gt7u6ohjyyd.onion'
+privacy_policy: 'https://divestos.org/index.php?page=privacy_policy'
+downloads:
+  - icon: fab fa-github
+    url: 'https://github.com/divested-mobile'
+  - icon: fab fa-gitlab
+    url: 'https://gitlab.com/divested-mobile'

_data/software/browsers-desktop/1_firefox.yml

@@ -28,16 +28,16 @@ description: |
   <h4>Arkenfox (advanced)</h4>
   The <a href="https://github.com/arkenfox/user.js">Arkenfox project</a> provides a set of carefully considered options for Firefox. These options are quite strict but a few are subjective and can sometimes cause a website to not work properly. You can easily change these settings to suit your needs. We <strong>strongly recommend</strong> reading through the <a href="https://github.com/arkenfox/user.js/wiki">basics</a> section. Arkenfox also enables <a href="https://support.mozilla.org/en-US/kb/containers#w_for-advanced-users">container</a> support.
 
-website: 'https://firefox.com/'
-privacy_policy: 'https://www.mozilla.org/privacy/firefox/'
+website: 'https://firefox.com'
+privacy_policy: 'https://www.mozilla.org/privacy/firefox'
 downloads:
   - icon: fab fa-windows
-    url: 'https://www.mozilla.org/firefox/windows/'
+    url: 'https://www.mozilla.org/firefox/windows'
   - icon: fab fa-apple
-    url: 'https://www.mozilla.org/firefox/mac/'
+    url: 'https://www.mozilla.org/firefox/mac'
   - icon: fab fa-linux
-    url: 'https://www.mozilla.org/firefox/linux/'
+    url: 'https://www.mozilla.org/firefox/linux'
   - icon: fab fa-freebsd
     url: 'https://www.freshports.org/www/firefox'
   - icon: fab fa-git
-    url: 'https://hg.mozilla.org/mozilla-central/'
+    url: 'https://hg.mozilla.org/mozilla-central'

_data/software/browsers-mobile/1_bromite.yml

@@ -18,7 +18,7 @@ description: |
     <li>Select: <strong>Open external links in incognito</strong>.</li>
   </ul>
 
-website: 'https://www.bromite.org/'
+website: 'https://www.bromite.org'
 privacy_policy: 'https://www.bromite.org/privacy'
 downloads:
   - icon: fab fa-android

_data/software/browsers-mobile/3_firefox.yml

@@ -12,8 +12,8 @@ description: |
   <h5><strong>Sanitizing on close</strong></h5>
   Firefox iOS does not have have an option to clear cache on quit so you must do it manually. ( ≡ → ⚙️ Settings → Data Management).
 
-website: 'https://firefox.com/'
-privacy_policy: 'https://www.mozilla.org/privacy/firefox/'
+website: 'https://firefox.com'
+privacy_policy: 'https://www.mozilla.org/privacy/firefox'
 downloads:
   - icon: fab fa-app-store-ios
     url: 'https://apps.apple.com/app/id989804926'

_data/software/browsers-mobile/4_firefox_focus.yml

@@ -12,8 +12,8 @@ description: |
   <h4>Notes</h4>
   Focus only lets you open one tab at a time.
 
-website: 'https://firefox.com/'
-privacy_policy: 'https://www.mozilla.org/privacy/firefox/'
+website: 'https://firefox.com'
+privacy_policy: 'https://www.mozilla.org/privacy/firefox'
 downloads:
   - icon: fab fa-app-store-ios
     url: 'https://apps.apple.com/app/id1055677337'

_includes/legacy/sections/android-addons.html

@@ -1,33 +0,0 @@
-<h2 id="aaddons" class="anchor"><a href="#aaddons"><i class="fas fa-link anchor-icon"></i></a> Android Privacy Add-ons</h2>
-
-<div class="container-fluid">
-
-  <div class="row mb-2">
-    <div class="col-lg-3 col-sm-12 pt-lg-5">
-      <img src="/assets/img/legacy_png/3rd-party/netguard.png" height="70" width="70" class="img-fluid d-block me-auto ms-auto align-middle" alt="NetGuard">
-    </div>
-    <div class="col">
-    <h3>Control your traffic with <a href="https://www.netguard.me/">NetGuard</a></h3>
-    <p><strong>NetGuard</strong> provides simple and advanced methods to block certain apps from accessing the internet, without requiring root privileges. Applications and addresses can be individually allowed or denied access to your Wi-Fi and/or mobile connections, allowing you to control exactly which apps are able to phone home or not.</p>
-    </div>
-  </div>
-
-  <div class="row mb-2">
-    <div class="col-lg-3 col-sm-12 pt-lg-5">
-      <img src="/assets/img/legacy_svg/3rd-party/orbot.svg" height="70" width="70" class="img-fluid d-block me-auto ms-auto align-middle" alt="Orbot">
-    </div>
-    <div class="col">
-    <h3>Tor for Android with <a href="https://guardianproject.info/apps/orbot/">Orbot</a></h3>
-    <p><strong>Orbot</strong> is a free proxy app that empowers other apps to use the internet more securely. Orbot uses Tor to encrypt your Internet traffic and then hides it by bouncing through a series of computers around the world.</p>
-    </div>
-  </div>
-
-</div>
-
-<h2>See also</h2>
-
-<ul>
-  <li>
-    <a href="/providers/dns#dns-android-clients">Our DNS client recommendations</a>, which have information on enabling encrypted DNS on Android.
-  </li>
-</ul>

_includes/legacy/sections/android-operating-systems.html

@@ -1,32 +0,0 @@
-<h2 id="mobile_os" class="anchor"><a href="#mobile_os"><i class="fas fa-link anchor-icon"></i></a> Mobile Operating Systems</h2>
-
-{% include legacy/cardv2.html
-  title="GrapheneOS"
-  image="/assets/img/legacy_svg/3rd-party/grapheneos.svg"
-  image-dark="/assets/img/legacy_svg/3rd-party/grapheneos-dark.svg"
-  description='GrapheneOS is a free and open-source security and privacy-focused mobile operating system built on top of the Android Open Source Project. It expands upon android security by providing a <a href="https://github.com/GrapheneOS/hardened_malloc">hardened memory allocator</a>, network and sensors permission, <a href="https://grapheneos.org/usage#sandboxed-play-services">sandboxed Play Services support</a>, and various other <a href="https://grapheneos.org/features">security features</a>. Using GrapheneOS is recommended if you want the utmost security for your device. Currently, only <a href="https://grapheneos.org/faq#device-support">Pixel phones</a> are supported.'
-  badges="info:AOSP"
-  website="https://grapheneos.org"
-  github="https://github.com/GrapheneOS"
-%}
-
-{% include legacy/cardv2.html
-  title="CalyxOS"
-  image="/assets/img/legacy_svg/3rd-party/calyxos.svg"
-  description='CalyxOS is a custom ROM based on the Android Open Source Project, with support for <a href="https://calyxos.org/docs/guide/device-support/">Google Pixel devices and the Xiaomi Mi A2</a>. It aims to be secure and private by default, and includes a number of good choices for default applications. Some of its features include optional <a href="https://microg.org/">MicroG</a> support and a built-in <a href="https://calyxos.org/docs/tech/datura-details/">firewall</a>. It should be noted that CalyxOS lacks a lot of the security hardening that GrapheneOS has, such as a hardened memory allocator, hardened webview, more <a href="https://grapheneos.org/usage#exec-spawning">secure spawning system</a>, and so on.'
-  badges="info:AOSP"
-  website="https://calyxos.org"
-  gitlab="https://gitlab.com/calyxos"
-%}
-
-{% include legacy/cardv2.html
-  title="DivestOS"
-  image="/assets/img/legacy_svg/3rd-party/divestos.svg"
-  description='DivestOS is a soft-fork of <a href="https://lineageos.org/">LineageOS</a> with signed builds, automated kernel vulnerability (CVE) patching, fewer proprietary blobs, along with bundled <a href="https://www.f-droid.org/">F-Droid</a> and <a href="https://github.com/microg/UnifiedNlp">UnifedNlp</a>. Not all of its supported devices support <a href="https://source.android.com/security/verifiedboot">verified boot</a>, and DivestOS does not handle firmware updates well currently. For Pixel devices, we still recommend using GrapheneOS or CalyxOS. For other <a href="https://divestos.org/index.php?page=devices&base=LineageOS">supported devices</a>, DivestOS is a good option.'
-  badges="info:AOSP"
-  website="https://divestos.org"
-  tor="http://divestoseb5nncsydt7zzf5hrfg44md4bxqjs5ifcv4t7gt7u6ohjyyd.onion"
-  privacy-policy="https://divestos.org/index.php?page=privacy_policy"
-  github="https://github.com/divested-mobile"
-  gitlab="https://gitlab.com/divested-mobile"
-%}

_includes/legacy/sections/ios-addons.html

@@ -23,11 +23,3 @@
   </div>
 
 </div>
-
-<h2>See also</h2>
-
-<ul>
-  <li>
-    <a href="/providers/dns#dns-ios-clients">Our DNS client recommendations</a>, which have information on enabling encrypted DNS on iOS.
-  </li>
-</ul>

_layouts/default.html

@@ -11,5 +11,6 @@
   <script src="/assets/js/vendor/bootstrap.bundle.min.js?v=5.1.1"></script>
   <script src="/assets/js/sortable.min.js?v=20210506"></script>
   <script src="/assets/js/main.js?v=20210506"></script>
+  {% if page.mathjax %}<script src="/assets/js/vendor/tex-svg.js"></script>{% endif %}
 </body>
 </html>

assets/img/android/auditor.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"><path d="m16.933-1.6667e-7 -13.855 6.1576v9.2364c0 8.5436 5.9113 16.533 13.855 18.473 7.9433-1.9397 13.855-9.9291 13.855-18.473v-9.2364zm0 16.918h10.776c-0.81588 6.3423-5.0492 11.992-10.776 13.762v-13.747h-10.776v-8.7746l10.776-4.7875z" fill="#1a1a1a" stroke-width="1.5394"/><path d="m16.415 18.141h6.35v6.35h-6.35z" fill="none" stroke-width=".26458"/></svg>

collections/_evergreen/android.html

@@ -0,0 +1,175 @@
+---
+layout: evergreen
+title: Android
+mathjax: true
+description: "Android is a secure operating system that has strong <a href='https://source.android.com/security/app-sandbox'>app sandboxing</a>, <a href='https://source.android.com/security/verifiedboot'>verified boot</a>, and a robust <a href='https://developer.android.com/guide/topics/permissions/overview'>permission</a> control system.
+
+The main privacy concern with most Android devices is that they usually include <a href='https://developers.google.com/android/guides/overview'>Google Play Services</a>. This component is proprietary, closed source, has a privileged role on your phone and may collect private user information. It is not a part of the <a href='https://source.android.com/'>Android Open Source Project (AOSP)</a> nor is it included with the below derivatives."
+---
+
+<h2 id="mobile-only-recommendations" class="anchor">
+    <a href="#aosp-derivatives"><i class="fas fa-link anchor-icon"></i></a>
+    AOSP Derivatives
+</h2>
+
+{% for item_hash in site.data.operating-systems.android %}
+{% assign item = item_hash[1] %}
+
+{% if item.type == "Recommendation" %}
+{% include recommendation-card.html %}
+{% endif %}
+
+{% endfor %}
+
+<h2 id="android-security-privacy" class="anchor">
+    <a href="#android-security-privacy"><i class="fas fa-link anchor-icon"></i></a>
+    Android security and privacy features
+</h2>
+
+<h5><strong>User Profiles</strong></h5>
+
+<p>Multiple user profiles (Settings → System → Multiple users) are the simplest way to isolate in Android. With user profiles you can limit a user from making calls, SMS or installing apps on the device. Each profile is encrypted using its own encryption key and cannot access the data of any other profiles. Even the device owner cannot view the data of other profiles without knowing their password. Multiple user profiles is a more secure method of isolation.</p>
+
+<h5><strong>Work Profile</strong></h5>
+<p><a href="https://support.google.com/work/android/answer/6191949">Work profiles</a> are another way to isolate individual apps and may be more convenient than separate user profiles.</p>
+
+<p>A <strong>device controller</strong> such as <a href="/android/#recommended-apps">Shelter</a> is required, unless you're using CalyxOS which includes one.</p>
+
+<p>The work profile is dependent on a device controller to function. Features such as <em>File Shuttle</em> and <em>contact search blocking</em> or any kind of isolation features must be implemented by the controller. The user must also fully trust the device controller app, as it has full access to the data inside of the work profile.</p>
+
+<p>This method is generally less secure than a secondary user profile, however, it does allow you the convenience of running run apps in both the work and personal profiles simultaneously.</p>
+
+<h5><strong>Verified Boot</strong></h5>
+<p><a href='https://source.android.com/security/verifiedboot'>Verified boot</a> is an important part of the Android security model. It provides protection against <a href="https://en.wikipedia.org/wiki/Evil_maid_attack">Evil maid</a> attacks, malware persistence, and ensures security updates cannot be downgraded with <a href="https://source.android.com/security/verifiedboot/verified-boot#rollback-protection">rollback protection</a>.</p>
+
+<p>Android 10 and above has moved away from full disk encryption (FDE) to more flexible <a href="https://source.android.com/security/encryption/file-based">file based </a> encryption.</p>
+
+<p>Each user's data is encrypted using their own unique encryption key, and the operating system files are left unencrypted. Verified boot ensures the integrity of the operating system files preventing an adversary with physical access from tampering or installing malware on the device. In the unlikely case that malware is able to exploit other parts of the system and gain higher privileged access, verified boot will prevent and revert changes to the system partition upon reboot of the device.</p>
+
+<p>Unfortunately, original equipment manufacturers (OEMs) are only obliged to support verified boot on their stock Android distribution. Only a few OEMs such as Google support custom Android Verified Boot (AVB) key enrollment on their devices. Some AOSP derivatives such as LineageOS or /e/ OS do not support verified boot even on hardware with verified boot support for third party operating systems. We recommend that you check for support <strong>before</strong> purchasing a new device. AOSP derivatives which do not support verified boot are <strong>not</strong> recommended.</p>
+
+<h5><strong>VPN Killswitch</strong></h5>
+<p>Android 7 and above supports a VPN killswitch and it is available without the need to install third party apps. This feature can prevent leaks if the VPN is disconnected. It can be found in (⚙️ Settings → Network & internet → VPN → ⚙️ → Block connections without VPN).</p>
+
+<h5><strong>Global Toggles</strong></h5>
+<p>Modern Android devices have global toggles for disabling <a href="https://en.wikipedia.org/wiki/Bluetooth">Bluetooth</a> and location services. Android 12 introduced toggles for the camera and microphone. When not in use, we recommend disabling these features. Apps cannot use disabled features (even if granted individual permission) until renabled.</p>
+
+<h2 id="recommended-apps" class="anchor">
+    <a href="#recommended-apps"><i class="fas fa-link anchor-icon"></i></a>
+    Recommended Apps
+</h2>
+
+{% for item_hash in site.data.operating-systems.android-applications %}
+{% assign item = item_hash[1] %}
+
+{% if item.type == "Recommendation" %}
+{% include recommendation-card.html %}
+{% endif %}
+
+{% endfor %}
+
+<h2 id="general-recommendations" class="anchor">
+    <a href="#general-recommendations"><i class="fas fa-link anchor-icon"></i></a>
+    General Recommendations
+</h2>
+
+<h5><strong>Android Rooting</strong></h5>
+<p>Rooting Android phones can decrease security significantly as it weakens the complete Android security model. This can decrease privacy should there be an exploit that is assisted by the decreased security. Common rooting methods involve directly tampering with the boot partition, making it impossible to perform successful <a href='https://source.android.com/security/verifiedboot'>verified boot</a>. Apps that require root will also modify the system partition meaning that verified boot would have to remain disabled. Having root exposed directly in the user interface also increases the <a href="https://en.wikipedia.org/wiki/Attack_surface">attack surface</a> and may assist in <a href="https://en.wikipedia.org/wiki/Privilege_escalation">privilege escalation</a> vulnerabilities and <a href="https://en.wikipedia.org/wiki/Security-Enhanced_Linux">SELinux</a> policy bypasses.</p>
+
+<p>Adblockers (Adaway) which modify the <a href="https://en.wikipedia.org/wiki/Hosts_(file)">hosts file</a> and firewalls (AFWall+) which require root access persistently are dangerous and should not be used. They are also not the correct way to solve their intended purposes. For Adblocking we suggest <a href="/providers/dns/">DNS</a> or <a href="/providers/vpn/">VPN</a> based blocking solutions instead. Adaway in non-root mode will take up the VPN slot preventing you from using privacy enhancing services such as Orbot or a VPN. AFWall+ works based on the <a href="#graphene-calyxos">packet filtering approach</a> and is bypassable in some situations.</p>
+
+<p>We do not believe that the security sacrifices made by rooting a phone are worth the questionable privacy benefits of those apps.</p>
+
+<h5><strong>Firmware Updates</strong></h5>
+
+<p>Firmware updates are critical for maintaining security and without them your device cannot be secure. Original equipment manufacturers (OEMs) - phone manufacturers have support agreements with their partners to provide the closed source components for a limited support period. These are detailed in the monthly <a href="https://source.android.com/security/bulletin">Android Security Bulletins</a>.</p>
+
+<p>As the components of the phone such as the processor and radio technologies rely on closed source components, the updates must be provided by the respective manufacturers. Therefore it is important that you purchase a device within an active support cycle. <a href="https://www.qualcomm.com/news/releases/2020/12/16/qualcomm-and-google-announce-collaboration-extend-android-os-support-and">Qualcomm</a> and <a href="https://news.samsung.com/us/samsung-galaxy-security-extending-updates-knox/">Samsung</a> support their devices for 4 years while cheaper products often have shorter support. With the introduction of the <a href=https://support.google.com/pixelphone/answer/4457705>Pixel 6</a>, Google now makes their own system on chip (SoC) and they will provide 5 years of support.</p>
+
+<p>Fairphone claims that they will support their device for <a href="https://arstechnica.com/gadgets/2021/09/fairphone-4-has-an-incredible-5-year-warranty-aims-for-6-years-of-updates/">6 years</a>. However, as they use Qualcomm SoC there has been some <a href="https://twitter.com/DanielMicay/status/1444028533186117633">skepticism</a> surrounding that claim.</p>
+
+<p>Devices that have reached their end-of-life (EoL) and are no longer supported by the SoC manufacturer, cannot receive firmware updates from OEM vendors or after market Android distributors. This means that security issues with those devices will remain unfixed.</p>
+
+<h5><strong>Android versions</strong></h5>
+<p>It's also important to make sure that you're not using an <a href="https://endoflife.date/android">end-of-life</a> version of Android. Newer versions of Android not only receive security updates for the operating system but also important privacy enhancing updates too. For example, <a href="https://developer.android.com/about/versions/10/privacy/changes">prior to Android 10</a>, any user apps with the <a href="https://developer.android.com/reference/android/Manifest.permission#READ_PHONE_STATE"><code>READ_PHONE_STATE</code></a> permission could access sensitive and unique serial numbers of your phone such as <a href="https://en.wikipedia.org/wiki/International_Mobile_Equipment_Identity">IMEI</a>, <a href="https://en.wikipedia.org/wiki/Mobile_equipment_identifier">MEID</a>, your SIM card's <a href="https://en.wikipedia.org/wiki/International_mobile_subscriber_identity">IMSI</a>, whereas now they must be system apps to do so. System apps are only shipped by the OEM or Android distribution.</p>
+
+<h5><strong>Android Permissions</strong></h5>
+<p><a href="https://developer.android.com/guide/topics/permissions/overview">Permissions on Android</a> grant users control over what apps are allowed to access. Google regularly makes <a href="https://developer.android.com/about/versions/11/privacy/permissions">improvements</a> on the permission system in each successive version. All user installed apps are strictly <a href="https://source.android.com/security/app-sandbox">sandboxed</a>, therefore there is no need to install any antivirus apps. The savings you make from not purchasing or subscribing to security apps is better spent on paying for a supported device in the future.</p>
+
+<p>Should you want to run an app that you're unsure about consider using a user or work <a href="/android/#android-security-privacy">profile</a>.</p>
+
+<h5><strong>Android Device Shopping</strong></h5>
+<p>Google Pixels are known to have good security and properly support <a href="https://source.android.com/security/verifiedboot">verified boot</a>. Some other phones such as the Fairphone and Oneplus devices also support custom Android verified boot (AVB) key enrollment. However, there have been issues with their older models. In the past they were using <a href="https://social.coop/@dazinism/105346943304083054">test keys</a> or not doing proper verification, making verified boot on those devices useless.</p>
+
+<p>Avoid buying phones from mobile network operators. These often have a <strong>locked bootloader</strong> and do not support <a href="https://source.android.com/devices/bootloader/locking_unlocking">OEM unlocking</a>. These phone variants will prevent you from installing any kind of alternative Android distribution. Phones that cannot be unlocked will often have an <a href="https://en.wikipedia.org/wiki/International_Mobile_Equipment_Identity">IMEI</a> starting with "35", that includes phones from purchased from Verizon, Telus, Rogers, EE etc.</p>
+
+<p>Be very <strong>careful</strong> about buying second hand phones from online marketplaces. Always check the reputation of the seller. If the device is stolen there's a possibility of <a href="https://www.gsma.com/security/resources/imei-blacklisting/">IMEI blacklisting</a>. There is also a risk involved with you being associated with the activity of the previous owner.</p>
+
+We have these general tips:
+<ul>
+  <li>If you're after a bargain on a Pixel device, we suggest buying an "<strong>a</strong>" model, just after the next flagship is released. Discounts are usually available because Google will be trying to clear their stock.</li>
+  <li>Consider price beating options and specials offered at <a href="https://en.wikipedia.org/wiki/Brick_and_mortar">brick and mortar</a> stores.</li>
+  <li>Look at online community bargain sites in your country. These can alert you to good sales.</li>
+  <li>The price per day for a device can be calculated as \({\text {EoL Date}-\text{Current Date} \over \text{Cost}}\). Google provides a <a href="https://support.google.com/nexus/answer/4457705">list</a> of their supported devices.</li>
+  <li>Do not buy devices that have reached or are near their end-of-life, additional firmware updates must be provided by the manufacturer.</li>
+  <li>Do not buy preloaded LineageOS or /e/ OS phones or any Android phones without proper <a href="https://source.android.com/security/verifiedboot">verified boot</a> support and firmware updates. These devices also have no way for you to check whether they've been tampered with.</li>
+  <li>In short, if a device or Android distribution is not listed here, there is probably a good reason, so check our <a href="https://github.com/privacyguides/privacyguides.org/discussions">discussions</a> page.</li>
+</ul>
+
+<p>The installation of GrapheneOS on a Pixel phone is easy with their <a href="https://grapheneos.org/install/web">web installer</a>. If you don't feel comfortable doing it yourself and are willing to spend a bit of extra money, check out the <a href="https://shop.nitrokey.com/shop">NitroPhone</a> as they come preloaded with GrapheneOS from the reputable <a href="https://www.nitrokey.com/about">Nitrokey</a> company. The GrapheneOS project is not currently affiliated with any vendor and cannot ensure the quality or security of their products.</p>
+
+<p>A <a href="https://calyxinstitute.org/membership/calyxos">CalyxOS membership</a> also entitles you to a device preloaded with CalyxOS.</p>
+
+<h2 id="graphene-calyxos" class="anchor">
+    <a href="#graphene-calyxos"><i class="fas fa-link anchor-icon"></i></a>
+    Security comparison of GrapheneOS and CalyxOS
+</h2>
+
+<h5><strong>Profiles</strong></h5>
+<p>CalyxOS includes a device controller app so there is no need to install a third party app like <a href="/android/#recommended-apps">Shelter</a>. GrapheneOS plans to introduce nested profile support with better isolation in the future.</p>
+
+<p>GrapheneOS extends the <a href="/android/#android-security-privacy">user profile</a> feature allowing a user to press an "End Session" button. This button clears the encryption key from memory. There are plans to add a <a href="https://github.com/GrapheneOS/os-issue-tracker/issues/88">cross profile notifications system</a> in the future.</p>
+
+<h5><strong>INTERNET permission vs packet filtering</strong></h5>
+<p><a href="https://en.wikipedia.org/wiki/Firewall_(computing)#Packet_filter">Packet filter</a> based solutions such <a href="/android/#graphene-calyxos">Daruta Firewall</a>, <a href="https://gitlab.com/LineageOS/issues/android/-/issues/3228">LineageOS</a> (DivestOS), AFWall+ and Netguard, are not ideal as they can leak and don't prevent an app from proxying a network request through another app using an <a href="https://developer.android.com/guide/components/intents-filters">intent</a>. Other filtering solutions such as RethinkDNS also prevent you from using a VPN at the same time.</p>
+
+<p>Android has a built-in <a href="https://developer.android.com/training/basics/network-ops/connecting"><code>INTERNET</code></a> permission. This is enforced by the operating system. On AOSP and most of its derivatives, it is treated as an install time permission. GrapheneOS changes it to <a href="https://en.wikipedia.org/wiki/Runtime_(program_lifecycle_phase)">runtime</a> permission, meaning that it can be revoked to deny internet access to a specific app.</p>
+
+<p>The <a href="https://developer.android.com/training/basics/network-ops/connecting"><code>INTERNET</code></a> permission is a strong way of controlling internet access. It also blocks direct access to the internet and access to other APIs that rely on the <a href="https://developer.android.com/training/basics/network-ops/connecting"><code>INTERNET</code></a> permission. The only way for an app to circumvent it is for it to communicate with another app that has been granted <a href="https://developer.android.com/training/basics/network-ops/connecting"><code>INTERNET</code></a> permission via mutual consent. Such communication can be prevented by putting apps into seperate profiles.</p>
+
+<p>Some apps might crash if their <a href="https://developer.android.com/training/basics/network-ops/connecting"><code>INTERNET</code></a>  permission is revoked. CalyxOS instead uses a <a href="https://calyxos.org/docs/tech/datura-details">firewall</a> to achieve a similar outcome however, in some circumstances CalyxOS's approach may leak (<a href="https://gitlab.com/CalyxOS/calyxos/-/issues/572">#572</a>, <a href="https://gitlab.com/CalyxOS/calyxos/-/issues/581">#581</a>).
+
+<h5><strong>Sandboxed Play Services vs Privileged MicroG</strong></h5>
+<p>When Google Play services are used on GrapheneOS, they run as a user app and are contained within a user or work profile.</p>
+
+<p>Sandboxed Play Services are confined using the highly restrictive, default <a href="https://source.android.com/security/selinux/concepts"><code>untrusted_app</code></a> domain provided by <a href="https://en.wikipedia.org/wiki/Security-Enhanced_Linux">SELinux</a>. Permissions for apps to use Play Services can be revoked at any time by the user.</p>
+
+<p>MicroG is a reimplementation of Google Play Services. This means it needs to be updated every time Android has a major version update (or the Android API changes). It also needs to run in the highly privileged <a href="https://source.android.com/security/selinux/concepts"><code>system_app</code></a> SELinux domain like the normal Play Services and is less secure than the Sandboxed Play Service approach. We do not believe MicroG provides any privacy advantages over Sandboxed Play Services except for the option to <em>shift trust</em> of the location backend from Google to another provider such as Mozilla or DejaVu.</p>
+
+<h5><strong>Device Patch Level</strong></h5>
+
+<p>GrapheneOS includes the latest Android 12 and comes with full firmware security patches for non "extended support" devices. If it is <a href="https://support.google.com/nexus/answer/4457705">supported</a> you will have the latest security patch level.</p>
+
+<p>CalyxOS <a href="https://gitlab.com/groups/CalyxOS/-/epics/28">has not yet finished</a> Android 12 support. This means they cannot include the updated <a href="https://calyxos.org/docs/guide/security/bulletin/">proprietary</a> firmware with security patches that were designed for Android 12.</p>
+
+<h5><strong>Privileged App Extensions</strong></h5>
+
+<p>Android 12 comes with special support for seamless app updates with <a href="https://android-developers.googleblog.com/2020/09/listening-to-developer-feedback-to.html">third party app stores</a>. The popular Free and Open Source Software (FOSS) repository <a href="https://f-droid.org">F-Droid</a> doesn't implement this feature and requires a <a href="https://f-droid.org/en/packages/org.fdroid.fdroid.privileged">privileged extension</a> to be included with the Android distribution in order to have unattended app installation.</p>
+
+<p>GrapheneOS doesn't compromise on security, therefore they do not include the F-Droid extension therefore, users have to confirm all updates manually if they want to use F-Droid. GrapheneOS officially recommends <a href="https://grapheneos.org/usage#sandboxed-play-services">Sandboxed Play Services</a> instead. Many FOSS Android apps are also in Google Play but sometimes they are not (like <a href="/video-streaming/">Newpipe</a>).</p>
+
+<p>CalyxOS includes the <a href="https://f-droid.org/en/packages/org.fdroid.fdroid.privileged">privileged extension</a>, which may lower device security. Seemless app updates should be possible with <a href="https://auroraoss.com">Aurora Store</a> when CalyxOS is upgraded to Android 12 and <a href="https://gitlab.com/AuroraOSS/AuroraStore/-/merge_requests/153">#153</a> is completed.</p>
+
+<h5><strong>Additional Hardening</strong></h5>
+<p>GrapheneOS improves upon <a href="https://source.android.com/">AOSP</a> security with:</p>
+
+<ul>
+  <li><strong>Hardened WebView:</strong> Vanadium WebView requires <a href="https://en.wikipedia.org/wiki/64-bit_computing">64-bit</a> processes on the <a href="https://developer.android.com/reference/android/webkit/WebView">WebView</a> process and disables legacy <a href="https://en.wikipedia.org/wiki/32-bit_computing">32-bit</a> processes. It uses hardened compiler options such as <a href="https://gcc.gnu.org/onlinedocs/gcc/Code-Gen-Options.html"><code>-fwrapv</code></a> and <a href="https://gcc.gnu.org/onlinedocs/gcc-4.9.3/gcc/Optimize-Options.html"><code>-fstack-protector-strong</code></a>, which can help protect against <a href="https://en.wikipedia.org/wiki/Stack_buffer_overflow">stack buffer overflows</a>. <a href="https://en.wikipedia.org/wiki/API">API</a>s such as the <a href="https://chromestatus.com/feature/4537134732017664">battery status API</a> are disabled for privacy reasons. All system apps on GrapheneOS use the Vanadium WebView which means user installed apps that use WebView will also benefit from Vanadium's hardening. The <a href="https://github.com/GrapheneOS/Vanadium/tree/12/patches">Vanadium patch set</a> is a lot more comprehensive than CalyxOS's <a href="https://gitlab.com/CalyxOS/chromium-patches">Chromium patch set</a> which is derived from it.</li>
+
+  <li><strong>Hardened Kernel:</strong> GrapheneOS kernel includes some hardening from the <a href="https://github.com/GrapheneOS/linux-hardened">linux-hardened</a> project and the <a href="https://kernsec.org/wiki/index.php/Kernel_Self_Protection_Project">Kernel Self Protection Project (KSPP)</a>. CalyxOS uses the <a href="https://calyxos.org/docs/development/build/kernel/">same kernel</a> as regular Android with some minor modifications.</li>
+
+  <li><strong>Hardened Memory Allocator:</strong> GrapheneOS uses the <a href="https://github.com/GrapheneOS/hardened_malloc">hardened malloc</a> subproject as its memory allocator. This focuses on hardening against <a href="https://en.wikipedia.org/wiki/Memory_corruption">memory heap corruption</a>. CalyxOS uses the default AOSP <a href="https://source.android.com/devices/tech/debug/scudo">Scudo Malloc</a>, which is generally <a href="https://twitter.com/danielmicay/status/1033671709197398016">less effective</a>. Hardened Malloc has uncovered vulnerabilities in AOSP which have been <a href="https://github.com/GrapheneOS/platform_system_core/commit/be11b59725aa6118b0e1f0712572e835c3d50746">fixed</a> by GrapheneOS such as <a href="https://nvd.nist.gov/vuln/detail/CVE-2021-0703">CVE-2021-0703</a>.</li>
+
+  <li><strong>Secure Exec Spawning:</strong> GrapheneOS <a href="https://en.wikipedia.org/wiki/Spawn_(computing)">spawns</a> fresh processes as opposed to using the <a href="https://ayusch.com/android-internals-the-android-os-boot-process">Zygote model</a> used by AOSP and CalyxOS. The Zygote model weakenes <a href="https://en.wikipedia.org/wiki/Address_space_layout_randomization">Address Space Layout Randomization</a> (ASLR) and is considered <a href="https://wenke.gtisc.gatech.edu/papers/morula.pdf">less secure</a>. Creating <a href="https://grapheneos.org/usage#exec-spawning">fresh processes</a> is safer but will have some performance penalty when launching a new application. These penalties are not really noticeable unless you have an <a href="https://support.google.com/nexus/answer/4457705">old device</a> with slow storage such as the Pixel 3a/3a XL as it has <a href="https://en.wikipedia.org/wiki/MultiMediaCard#eMMC">eMMC</a>.</li>
+</ul>
+<p><strong>Please note that these are just a few examples and are not an extensive list of GrapheneOS's hardening</strong>.</p>

legacy_pages/os.html

@@ -15,10 +15,6 @@ description: "Even your own computer could be compromising your privacy. Discove
 
 {% include legacy/sections/tor-operating-systems.html %}
 
-{% include legacy/sections/android-operating-systems.html %}
-
-{% include legacy/sections/android-addons.html %}
-
 {% include legacy/sections/ios-addons.html %}
 
 {% include legacy/sections/router-firmware.html %}

package-lock.json

@@ -10,7 +10,8 @@
       "license": "ISC",
       "dependencies": {
         "@fortawesome/fontawesome-pro": "^6.0.0-beta3",
-        "bootstrap": "^5.1.3"
+        "bootstrap": "^5.1.3",
+        "mathjax": "^3.2.0"
       }
     },
     "node_modules/@fortawesome/fontawesome-pro": {
@@ -42,6 +43,11 @@
       "peerDependencies": {
         "@popperjs/core": "^2.10.2"
       }
+    },
+    "node_modules/mathjax": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/mathjax/-/mathjax-3.2.0.tgz",
+      "integrity": "sha512-PL+rdYRK4Wxif+SQ94zP/L0sv6/oW/1WdQiIx0Jvn9FZaU5W9E6nlIv8liYAXBNPL2Fw/i+o/mZ1212eSzn0Cw=="
     }
   },
   "dependencies": {
@@ -61,6 +67,11 @@
       "resolved": "https://registry.npmjs.org/bootstrap/-/bootstrap-5.1.3.tgz",
       "integrity": "sha512-fcQztozJ8jToQWXxVuEyXWW+dSo8AiXWKwiSSrKWsRB/Qt+Ewwza+JWoLKiTuQLaEPhdNAJ7+Dosc9DOIqNy7Q==",
       "requires": {}
+    },
+    "mathjax": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/mathjax/-/mathjax-3.2.0.tgz",
+      "integrity": "sha512-PL+rdYRK4Wxif+SQ94zP/L0sv6/oW/1WdQiIx0Jvn9FZaU5W9E6nlIv8liYAXBNPL2Fw/i+o/mZ1212eSzn0Cw=="
     }
   }
 }

package.json

@@ -4,7 +4,7 @@
   "description": "",
   "main": "index.js",
   "scripts": {
-    "assets:copy:js": "mkdir -p assets/js/vendor && cp node_modules/bootstrap/dist/js/bootstrap.bundle.min.* assets/js/vendor/",
+    "assets:copy:js": "mkdir -p assets/js/vendor && cp node_modules/bootstrap/dist/js/bootstrap.bundle.min.* node_modules/mathjax/es5/tex-svg.js assets/js/vendor/",
     "assets:copy:icons": "mkdir -p assets/fonts/vendor/fontawesome && cp -a \"node_modules/@fortawesome/fontawesome-pro/.\" assets/fonts/vendor/fontawesome/",
     "assets:install": "npm run assets:copy:js && npm run assets:copy:icons",
     "build": "npm run assets:install && bundle exec jekyll build",
@@ -23,6 +23,7 @@
   "homepage": "https://github.com/privacyguides/privacyguides#readme",
   "dependencies": {
     "@fortawesome/fontawesome-pro": "^6.0.0-beta3",
-    "bootstrap": "^5.1.3"
+    "bootstrap": "^5.1.3",
+    "mathjax": "^3.2.0"
   }
 }