# WhatsApp Web Privacy Blur - Product Documentation

Version: 1.8.4  
Audience: Users, beta testers, founder, admin, support team

## 1. Product Summary

WhatsApp Web Privacy Blur is a privacy-first Chrome extension for WhatsApp Web. It helps users hide private content such as profile photos, names, chat previews, messages, documents, media, drafts, and sensitive data while using WhatsApp Web.

The extension works locally inside the browser. It does not collect analytics, does not track users, and does not send WhatsApp messages to any server.

## 2. Main Use Cases

### Screen Sharing

Use the extension before joining a meeting, demo, training call, or screen recording. It protects private WhatsApp content from being accidentally shown.

Recommended mode: `Screen Share`

### Office Work

Use it when working in shared spaces where coworkers may see your screen.

Recommended mode: `Office`

### Public Places

Use it in cafes, airports, libraries, coworking spaces, and public transport.

Recommended mode: `Public Place`

### Maximum Privacy

Use it when you want the strongest protection. This disables hover reveal and applies the strongest blur.

Recommended mode: `Maximum Privacy`

## 3. How To Install Locally

1. Open Chrome.
2. Go to `chrome://extensions`.
3. Enable `Developer mode`.
4. Click `Load unpacked`.
5. Select this folder:

   `C:\Users\Admin\Downloads\All Projects\Extentions Project\whatsapp-privacy-extension`

6. Open `https://web.whatsapp.com/`.
7. Click the extension icon and configure privacy settings.

## 4. How Users Should Use The Product

### Recommended Simple Flow

1. Open WhatsApp Web.
2. Open the extension popup.
3. Use the `Free features` tab.
4. Enable the privacy layers you need.
5. Adjust blur strength if needed.
6. Keep working normally.
7. Hover over blurred content only when you need to read it.

### Free Feature Flow

Use the Free tab if you only need basic privacy:

- Blur profile photos
- Blur contact names
- Blur chat previews
- Blur open chat messages
- Reveal on hover
- Blur strength

### Pro Feature Flow

Pro Features are currently a disabled preview. Payment and licensing are not live yet. Planned Pro features include:

- Privacy modes
- Password lock
- Auto-lock
- Panic shortcut
- Media and documents blur
- Message input blur
- Smart Sensitive Data Blur
- Per-chat rules
- Keyboard shortcuts
- Import/export settings
- WhatsApp Business Web support

## 5. Feature Documentation

### Master Privacy Toggle

Turns the whole privacy layer on or off.

Useful when:

- You want to temporarily disable all blur.
- You are alone and do not need privacy protection.

### Blur Profile Photos

Blurs contact and group avatars in the WhatsApp sidebar and chat header.

Useful when:

- Screen sharing.
- Working in public or office areas.

### Blur Contact Names

Blurs contact and group names in the sidebar and chat header.

Useful when:

- Customer names are confidential.
- Personal contacts should not be visible.

### Blur Chat Previews

Blurs latest message previews in the chat list.

Useful when:

- Chat previews may reveal private messages.
- You are showing WhatsApp Web on a shared screen.

### Blur Open Chat Messages

Blurs messages inside the selected chat.

Important behavior:

- The message reveals only when hovering actual message content.
- Moving the mouse over an empty horizontal lane should not reveal the message.

### Reveal On Hover

Temporarily removes blur when the cursor is over a blurred item.

Useful when:

- You want privacy but still need fast access to content.

Disable this in high-risk cases by using `Maximum Privacy`.

### Blur Strength

Controls blur intensity from 1px to 10px.

Default: `5px`

Recommended:

- Office: 5px
- Screen Share: 7px
- Public Place: 8px
- Maximum Privacy: 10px

### Privacy Modes

One-click presets for common privacy situations.

Modes:

- `Custom`: user-managed settings.
- `Office`: balanced daily privacy.
- `Screen Share`: strong protection for calls and recordings.
- `Public Place`: stronger protection for public environments.
- `Maximum Privacy`: highest protection, disables hover reveal.

If the user changes an individual setting after applying a mode, the mode automatically changes to `Custom`.

### Password Lock

Locks WhatsApp Web until the privacy password is entered.

Security note:

- The plain password is not stored.
- A SHA-256 hash is stored in Chrome storage.

### Auto-Lock After Idle

Locks WhatsApp Web after no mouse or keyboard activity.

Requires:

- A saved password.

Useful when:

- User leaves desk.
- User forgets WhatsApp Web open.

### Panic Shortcut

Instantly locks WhatsApp Web.

Shortcut:

`Alt + Shift + P`

Requires:

- A saved password.

### Blur Media And Documents

Blurs:

- Photos
- Videos
- GIFs
- Document cards
- Files
- PDF/DOC/XLS/PPT/ZIP/RAR previews
- Download/document blocks

Useful when:

- Shared files reveal private information.
- Images/videos appear in chats during screen sharing.

### Blur Message Input Box

Blurs typed drafts in the message box.

Useful when:

- User is typing private content while screen sharing.

### Smart Sensitive Data Blur

Locally detects and blurs sensitive text patterns.

Can blur:

- OTPs
- Emails
- Phone numbers
- Links
- UPI/payment IDs
- Transaction references
- Amounts
- Long card/account-like numbers

Important:

- Detection runs locally.
- No message data is sent to a server.

### Screen-Sharing-Only Blur

Applies blur only while screen sharing starts from the WhatsApp Web tab.

Limit:

- External Zoom/Meet screen sharing started outside WhatsApp cannot always be detected reliably.

### Per-Chat Whitelist/Blacklist

Allows different behavior per chat.

Modes:

- `All chats`
- `Only whitelisted chats`
- `Exclude blacklisted chats`

Useful when:

- Certain business chats need stronger privacy.
- Certain personal chats should not be blurred.

### Keyboard Shortcuts

Shortcut:

`Alt + Shift + W`

Use it to toggle privacy mode quickly.

### Import/Export Settings

Exports or imports extension settings as a JSON file.

Useful when:

- Moving to another browser/device.
- Restoring settings after reset.
- Support asks user to share non-sensitive settings.

### WhatsApp Business Web Support

The extension runs on:

- `https://web.whatsapp.com/`
- `https://business.whatsapp.com/`

## 6. Founder Notes

### Product Positioning

Position the product as:

`A privacy layer for WhatsApp Web during screen sharing, office work, and public spaces.`

Do not position it as:

- CRM software
- WhatsApp automation tool
- Bulk messaging tool

This keeps the product focused and lowers policy/support risk.

### Free vs Pro Strategy

Free features should solve basic privacy.

Pro features should solve high-value privacy situations:

- Screen sharing
- Office/public space privacy
- Password lock
- Sensitive data blur
- Media/document protection
- Per-chat rules
- Privacy modes

### Why Users Would Pay

Users may pay because Pro saves them from:

- Accidental data exposure during screen sharing.
- Showing customer names or private chats in office.
- Revealing OTPs, payment IDs, documents, or media.
- Forgetting WhatsApp Web open.

## 7. Admin Operations

### Daily Admin Checklist

- Check support email.
- Review bug reports.
- Track Chrome Web Store reviews.
- Test WhatsApp Web after major WhatsApp UI changes.
- Update `CHANGELOG.md`.
- Prepare version updates when selectors break.

### Weekly Founder Checklist

- Review user feedback.
- Identify top requested Pro features.
- Improve screenshots and listing copy.
- Check install/uninstall feedback if available.
- Plan next release.

### Release Checklist

1. Update version in `manifest.json`.
2. Update `CHANGELOG.md`.
3. Run local QA.
4. Create extension ZIP.
5. Upload to Chrome Web Store.
6. Submit for review.
7. Notify beta testers.

## 8. Current Architecture

Current product is no-backend.

```txt
Chrome Extension
  -> Popup settings
  -> Chrome storage
  -> Content script
  -> WhatsApp Web DOM blur
```

No server is required for the current free/beta version.

## 9. Future Paid Architecture

Future paid version should use:

```txt
Chrome Extension
  -> Backend API
  -> Database
  -> Payment Provider
  -> Admin Dashboard
```

Recommended stack:

- Extension: Chrome MV3
- Website: Vercel or Netlify
- Backend: Next.js API or Node.js/Express
- Database: Supabase PostgreSQL
- Payment: Paddle, Stripe, or Razorpay

## 10. Trust And Compliance

Trust statements:

- No analytics.
- No tracking.
- No WhatsApp message collection.
- No external server needed for blur.
- Minimal permissions.
- Independent project, not affiliated with WhatsApp or Meta.

Before public launch:

- Support email configured: `privacyblur.support@gmail.com`.
- Host privacy policy on a public URL.
- Chrome Web Store link added: `https://chromewebstore.google.com/detail/whatsapp-web-privacy-blur/dkckbpalmbhdlcdacgcgabjgilkmpjil`.
- Add real screenshots.
- Add support email to store listing.
