@networkpro/web 1.12.2 → 1.12.3

package/CHANGELOG.md

@@ -12,6 +12,19 @@ This project attempts to follow [Keep a Changelog](https://keepachangelog.com/en
 
 ---
 
+## [1.12.3] - 2025-06-04
+
+### Added
+
+- `static/docs/pgp.md`, `pgp-win.md`, and `pgp-email.md` added for reference.  
+  These files have been temporarily stored until they can be migrated to the wiki.
+
+### Changed
+
+- Added the new Markdown files in `static/docs` to the `service-worker.js` cache ignore list.
+
+---
+
 ## [1.12.2] – 2025-06-04
 
 ### Changed

package/cspell.json

@@ -8,6 +8,7 @@
     "autorun",
     "BACKTOP",
     "beforeinstallprompt",
+    "Betterbird",
     "bootentry",
     "ccby",
     "CCPA",
@@ -22,12 +23,17 @@
     "homescreen",
     "HREFTOP",
     "Izzy",
+    "Keybase",
+    "keypair",
+    "keyserver",
+    "Kleopatra",
     "lhci",
     "lifecycles",
     "lighthouseci",
     "lighthouserc",
     "lightningcss",
     "linksheet",
+    "Mailvelope",
     "Maricopa",
     "mdsvex",
     "navigations",
@@ -43,8 +49,10 @@
     "npmjs",
     "ntfy",
     "obtainium",
+    "openpgp",
     "posthog",
     "prefs",
+    "publickey",
     "reconsent",
     "SIEM",
     "SPDY",
@@ -59,7 +67,8 @@
     "vcard",
     "vite",
     "vitest",
-    "webfonts"
+    "webfonts",
+    "Webmail"
   ],
   "ignorePaths": [
     ".gitignore",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@networkpro/web",
   "private": false,
-  "version": "1.12.2",
+  "version": "1.12.3",
   "description": "Locking Down Networks, Unlocking Confidence | Security, Networking, Privacy — Network Pro Strategies",
   "keywords": [
     "advisory",

package/src/service-worker.js

@@ -32,6 +32,10 @@ const excludedAssets = [];
 const IGNORE_PATHS = new Set([
   "/docs/extensions.md",
   "/docs/Home.md",
+  "/docs/pgp-email.md",
+  "/docs/pgp-win.md",
+  "/docs/pgp.md",
+  "/docs/tracking.md",
   "/img/banner-1280x640.png",
   "/img/logo-transparent.png",
   "/img/logo.png",

package/static/docs/pgp-email.md

@@ -0,0 +1,152 @@
+# 📧 Encrypting Email with PGP
+
+> This guide walks you through using PGP (Pretty Good Privacy) to encrypt email using both graphical and client-based tools.
+
+PGP encryption ensures that only the intended recipient can read your email content — even if it's intercepted.
+
+---
+
+## 🔹 Option A: Outlook (Windows) with GpgOL
+
+GpgOL is a plugin included with **Gpg4win** that integrates directly into Microsoft Outlook (desktop only).
+
+### ✅ Requirements
+
+- Gpg4win (with GpgOL selected during installation)
+- Outlook 2010 or newer (desktop version)
+- Recipient’s **public key**
+
+> ⚠️ GpgOL does not work with Outlook for Microsoft 365 Web or Outlook Mobile. It is only compatible with the **desktop edition of Outlook** on Windows.
+
+### 📥 Encrypting an Email in Outlook
+
+1. Open Outlook and compose a new message
+2. Enter the recipient’s email address (must match imported key)
+3. Click the `Encrypt` button on the **GpgOL ribbon** tab
+4. Send your email
+
+> ✉️ Outlook will encrypt the email contents using the recipient's public key.
+
+### 📥 Decrypting an Email in Outlook
+
+When receiving an encrypted message:
+
+- GpgOL will automatically prompt to decrypt it using your private key
+- You may need to enter your key passphrase
+
+> 💡 Tip: Manage keys with **Kleopatra** — launch from Start Menu
+
+---
+
+## 🔹 Option B: Thunderbird (Windows/macOS/Linux)
+
+Thunderbird includes **built-in OpenPGP** support and is often preferred for privacy-focused users.
+
+### ✅ Setup
+
+1. [Download Thunderbird](https://www.thunderbird.net)
+2. Add your email account
+3. Go to: `Account Settings → End-to-End Encryption`
+4. Generate a new key, or import your existing one
+5. Import your recipient’s **public key**
+
+### 🔐 Sending Encrypted Email
+
+When composing a message:
+
+- Click the **padlock** icon to enable encryption
+- Click **sign** if you also want to verify authenticity
+- Send as usual
+
+---
+
+## 🔹 Option C: Webmail with Mailvelope
+
+**Mailvelope** adds OpenPGP support to Gmail, Outlook.com, Yahoo, and others.
+
+### 🔧 Setup
+
+1. Install [Mailvelope](https://www.mailvelope.com/) for Chrome or Firefox
+2. Import your keys or generate a new pair
+3. Use the Mailvelope overlay when composing encrypted emails
+
+---
+
+## Alternative PGP-Compatible Email Clients
+
+In addition to widely used options like Outlook (via GpgOL) and Thunderbird, several other desktop email clients offer OpenPGP support—either natively or through plugins.
+
+Notable alternatives include:
+
+- **[Betterbird](https://www.betterbird.eu/):**  
+  A privacy-focused Thunderbird fork with full PGP support.  
+  ▸ Available on Windows, Linux, and macOS.
+
+- **[eM Client](https://www.emclient.com/):**  
+  A feature-rich client with native OpenPGP integration and calendar/task support.  
+  ▸ Available on Windows, macOS, Android, and iOS.  
+  ▸ _Free tier supports 2 email accounts after a 30-day trial._
+
+> 💡 **Note:** Be sure to verify the client’s compatibility with your GPG keyring (e.g., Gpg4win or Kleopatra on Windows).
+
+---
+
+## 📱 Mobile Email Clients with OpenPGP Support
+
+For secure email on Android, the following apps support OpenPGP encryption via [**OpenKeychain**](https://www.openkeychain.org/):
+
+- **[FairEmail](https://email.faircode.eu/)**  
+  A lightweight, privacy-first email client for Android, offering built-in OpenPGP support, rich customization, and a modern, privacy-respecting interface.
+
+- **[K-9 Mail](https://k9mail.app/)**  
+  A veteran open-source Android mail client known for its simplicity and transparency. K-9 is now maintained by the Thunderbird team as part of their mobile strategy.
+
+- **[Thunderbird Mobile](https://www.thunderbird.net/en-US/mobile/)**  
+  A mobile adaptation of Thunderbird, currently built on K-9 Mail and maintained by the same team. Provides end-to-end encryption and an open-source, user-friendly experience.
+
+> ⚠️ OpenPGP support on iOS is limited due to platform restrictions.  
+> Most options are proprietary or require external tools, and may not provide full compatibility with standard PGP workflows.
+
+---
+
+## 📤 Exporting and Sharing Public Keys
+
+You can export your public key from **Kleopatra**, Thunderbird, or the command line, and share it via:
+
+- Your website
+- A keyserver (e.g., [keys.openpgp.org](https://keys.openpgp.org))
+- Your GitHub profile (e.g., in `SECURITY.md` or a `PGP-KEY.asc` file)
+
+### 🔧 Export via Command Line
+
+If you’re using GnuPG directly:
+
+```sh
+gpg --armor --export your@email.com > publickey.asc
+```
+
+This creates a text-formatted (`.asc`) version of your public key that’s easy to upload or embed.
+
+> 💡 Replace `your@email.com` with the email associated with your PGP key.
+
+---
+
+## 🛠 Troubleshooting Tips
+
+- Ensure email address in key matches recipient’s address
+- Key must be **trusted/imported** before encryption works
+- For Outlook, restart if GpgOL ribbon does not appear
+- Thunderbird may require re-indexing of OpenPGP keyring
+
+---
+
+## 📚 Learn More
+
+- [Gpg4win Documentation](https://gpg4win.org/documentation.html)
+- [How to Encrypt Emails with OpenPGP in Thunderbird (2022)](https://www.linuxbabe.com/security/encrypt-emails-gpg-thunderbird)
+- [Mozilla OpenPGP Docs](https://support.mozilla.org/en-US/kb/openpgp-thunderbird-how-does-it-work)
+- [Mailvelope Overview](https://www.mailvelope.com/help)
+
+---
+
+> 🔐 PGP protects your communication, but both parties must be using it correctly. Always test before sending sensitive content.

package/static/docs/pgp-win.md

@@ -0,0 +1,67 @@
+# 💻 Using PGP on Windows (Gpg4win & Kleopatra)
+
+## This section walks through encrypting a message or file using **Gpg4win** and its GUI tool **Kleopatra**
+
+### 📦 1. Install Gpg4win
+
+- Download from: [https://gpg4win.org](https://gpg4win.org)
+- During setup, make sure **Kleopatra** is selected.
+
+---
+
+### 🔑 2. Import the Recipient’s Public Key
+
+1. Open **Kleopatra**
+2. Click `File` → `Import Certificates…`
+3. Select the `.asc` or `.gpg` file you downloaded
+4. Confirm the fingerprint matches the published value
+
+---
+
+### ✍️ 3. Encrypt a Message (Text)
+
+1. In Kleopatra, go to `Tools` → `Clipboard` → `Encrypt`
+2. Paste your message
+3. Select the recipient’s public key
+4. Click **Encrypt**
+5. Copy or save the armored output (begins with `-----BEGIN PGP MESSAGE-----`)
+
+You can now send that encrypted message via email or any communication platform.
+
+---
+
+### 📁 4. Encrypt a File
+
+1. Right-click on any file (e.g., PDF or TXT)
+2. Choose **More GpgEX options** → **Encrypt**
+3. Select the recipient key
+4. The encrypted file will be saved with a `.gpg` extension
+
+---
+
+### 🔓 5. Decrypt a Message or File
+
+To decrypt a file:
+
+- Right-click `.gpg` file → **Decrypt and verify**
+
+To decrypt a clipboard message:
+
+- In Kleopatra, go to `Tools` → `Clipboard` → `Decrypt/Verify`
+- Paste the encrypted message
+- Kleopatra will prompt for your private key if needed
+
+---
+
+### 🧠 Tips for Windows Users
+
+- Your private key is protected by a passphrase — never share it.
+- You can export your public key for others to encrypt messages to you.
+- Kleopatra also supports **signing** files and messages to verify your identity.
+
+---
+
+📘 For full walkthroughs, see:
+
+- [Gpg4win Documentation](https://gpg4win.org/documentation.html)
+- [Kleopatra User Guide (PDF)](https://files.gpg4win.org/doc/gpg4win-compendium-en.pdf)

package/static/docs/pgp.md

@@ -0,0 +1,71 @@
+# 🔐 How to Encrypt Messages Using PGP
+
+This guide explains how to encrypt a message or file using PGP (Pretty Good Privacy) for secure communication with **Network Pro Strategies** or any contact with a published PGP key.
+
+---
+
+## 📥 1. Obtain the Recipient's Public Key
+
+You can find the official public key at:
+
+- [https://netwk.pro/pgp](https://netwk.pro/pgp)
+- Or via GitHub, Keybase, or direct contact
+
+Make sure the key fingerprint matches what the recipient advertises.
+
+---
+
+## 🔧 2. Import the Public Key
+
+Save the public key as a `.asc` or `.gpg` file, then run:
+
+```bash
+gpg --import path/to/public-key.asc
+```
+
+You can confirm the key is imported:
+
+```bash
+gpg --list-keys
+```
+
+## 🔏 3. Encrypt a Message
+
+To encrypt a plain text file (e.g. message.txt) for the recipient:
+
+```bash
+gpg --encrypt --armor --recipient recipient@example.com message.txt
+```
+
+- --armor creates ASCII-formatted output
+- Output is saved as message.txt.asc
+
+## 🔏 4. Encrypt a File (Binary or Attachment)
+
+```bash
+gpg --encrypt --recipient recipient@example.com file.pdf
+```
+
+This will create file.pdf.gpg, which you can send securely.
+
+## 🔓 Optional: Decrypting (For Testing)
+
+If you're the recipient and want to decrypt a file:
+
+```bash
+gpg --decrypt file.txt.asc
+```
+
+## 🔐 Tips
+
+- Always verify the recipient’s key fingerprint.
+- Never share your private key.
+- Use a strong passphrase to protect your keypair.
+
+---
+
+📘 For more help, see:
+
+- [GnuPG Documentation](https://gnupg.org/documentation/)
+- [A Practical Guide to GPG](https://www.linuxbabe.com/security/a-practical-guide-to-gpg-part-1-generate-your-keypair)
+- [OpenPGP Best Practices](https://help.riseup.net/en/security/message-security/openpgp/best-practices)