From 3711e27865c70d8c88e067f30fd6b1d74d6f8648 Mon Sep 17 00:00:00 2001 From: Trish Whetzel Date: Sat, 6 Dec 2025 13:11:07 -0800 Subject: [PATCH] WIP --- PRIVACY_POLICY.md | 89 ++++++++++++++++ STORE_LISTING.md | 237 +++++++++++++++++++++++++++++++++++++++++ store-assets/README.md | 94 ++++++++++++++++ 3 files changed, 420 insertions(+) create mode 100644 PRIVACY_POLICY.md create mode 100644 STORE_LISTING.md create mode 100644 store-assets/README.md diff --git a/PRIVACY_POLICY.md b/PRIVACY_POLICY.md new file mode 100644 index 0000000..18106d0 --- /dev/null +++ b/PRIVACY_POLICY.md @@ -0,0 +1,89 @@ +# Privacy Policy for Gmail Row Highlighter + +**Last Updated:** [Date] + +## Overview + +Gmail Row Highlighter ("the Extension") is committed to protecting your privacy. This privacy policy explains how the Extension handles data. + +## Data Collection and Storage + +### What Data is Stored + +The Extension stores only the highlight rules you create, including: +- Rule type (sender, subject, label, etc.) +- Pattern text (the text you want to match) +- Background color preferences +- Rule enabled/disabled status + +### Where Data is Stored + +All data is stored locally in your browser using Chrome's sync storage API. This means: +- Your rules are stored on your device +- If you have Chrome sync enabled, your rules will sync across your devices +- No data is sent to external servers +- No data is transmitted to third parties + +### What Data is NOT Collected + +The Extension does NOT collect, transmit, or share: +- Your email content +- Email addresses (except those you explicitly enter as patterns) +- Personal information +- Browsing history +- Any analytics or usage data +- Any data sent to external servers + +## Permissions + +### Storage Permission + +The Extension uses Chrome's storage permission to save your highlight rules. This data is stored locally in your browser and synced across your devices if you have Chrome sync enabled. + +### Host Permission (mail.google.com) + +The Extension requires access to `mail.google.com` to: +- Inject the content script that highlights email rows +- Read email metadata (sender, subject, labels) to match against your rules + +**Important:** The Extension only reads email metadata (sender, subject, labels) to apply your highlight rules. It does NOT: +- Read email body content +- Send emails +- Modify emails +- Access any data outside of Gmail + +## Data Processing + +All data processing happens locally in your browser: +- Rule matching is performed in your browser +- No data is sent to external servers +- No third-party services are used +- No analytics or tracking is performed + +## Third-Party Services + +The Extension does not use any third-party services, analytics tools, or external APIs. + +## Data Sharing + +The Extension does not share any data with third parties. Your rules are stored locally and are never transmitted outside your browser. + +## Your Rights + +You have full control over your data: +- You can view all your rules in the Extension's options page +- You can edit or delete any rule at any time +- You can disable or uninstall the Extension, which will remove all stored rules +- All data is stored locally and can be cleared by clearing Chrome's extension storage + +## Changes to This Privacy Policy + +We may update this privacy policy from time to time. The "Last Updated" date at the top of this policy will reflect the most recent changes. + +## Contact + +If you have questions about this privacy policy, please open an issue on the Extension's GitHub repository. + +## Open Source + +This Extension is open source. You can review the source code to verify how data is handled. diff --git a/STORE_LISTING.md b/STORE_LISTING.md new file mode 100644 index 0000000..9110ff5 --- /dev/null +++ b/STORE_LISTING.md @@ -0,0 +1,237 @@ +# Chrome Web Store Listing Information + +This file contains all the information needed for the Chrome Web Store listing. Use this as a reference when creating or updating the extension's store listing. + +## Basic Information + +### Name +**Gmail Row Highlighter** + +### Short Description (132 characters max) +``` +Highlight Gmail message rows based on sender, subject, or label criteria with custom colors. Privacy-focused, all data stored locally. +``` + +### Category +**Productivity** + +### Language +**English (United States)** + +## Detailed Description + +Use the following description in the Chrome Web Store listing: + +``` +Highlight Gmail message rows based on user-defined rules. You can highlight emails by sender, subject, or label criteria with custom background colors. + +KEY FEATURES: + +✨ Flexible Rule Matching +Create rules to match emails by: +• Sender (email address or name) +• Subject line +• Sender or Subject (matches if pattern appears in either field) +• Gmail labels + +🔍 OR Pattern Matching +Use comma-separated patterns for OR logic (e.g., "googledev,GDG,Google Cloud" matches any of these terms) + +🎨 Custom Colors +Choose any background color for each rule to visually organize your inbox + +⚙️ Easy Management +• Edit rules: Modify rule type, pattern, or color after creation +• Quick color changes: Click any color swatch to quickly change a rule's color +• Enable/Disable: Toggle rules on and off without deleting them +• Real-time updates: Rules apply immediately without page reload + +🔒 Privacy-Focused +All data stored locally in your browser. No external servers, no data collection, no tracking. + +HOW TO USE: + +1. Right-click the extension icon and select "Options" +2. Create a rule by selecting: + - Rule Type (Sender, Subject, Sender or Subject, or Label) + - Pattern to match (supports comma-separated OR patterns) + - Background color +3. Click "Add Rule" +4. Open Gmail and see your emails highlighted! + +EXAMPLE RULES: + +• Highlight emails from a specific domain: + Type: Sender Contains | Pattern: @client.com + +• Highlight emails with specific subject keywords: + Type: Subject Contains | Pattern: Contract + +• Highlight emails with a specific label: + Type: Label Contains | Pattern: Important + +• Highlight emails matching multiple patterns: + Type: Sender or Subject Contains | Pattern: googledev,GDG,Google Cloud + +TECHNICAL DETAILS: + +• Manifest Version 3 +• Uses Chrome's sync storage (rules sync across devices) +• Only requires storage permission +• All processing happens locally in your browser +• Case-insensitive matching by default + +Perfect for organizing your inbox, prioritizing important emails, and quickly identifying messages from specific senders or topics. +``` + +## Promotional Images + +### Small Promotional Tile (440x280 pixels) +**Location:** `store-assets/promotional-small.png` +**Description:** Small promotional image shown in the Chrome Web Store. Should showcase the extension's main feature (highlighted Gmail rows). + +### Large Promotional Tile (920x680 pixels) +**Location:** `store-assets/promotional-large.png` +**Description:** Large promotional image shown on the extension's store page. Should include: +- Extension name +- Key features +- Visual example of highlighted Gmail rows + +### Marquee Promotional Tile (1400x560 pixels) +**Location:** `store-assets/promotional-marquee.png` +**Description:** Optional marquee image for featured placement. Should be visually striking and highlight the main value proposition. + +## Screenshots + +### Screenshot 1 (1280x800 or 640x400 pixels) +**Location:** `store-assets/screenshot-1.png` +**Description:** Main screenshot showing Gmail inbox with highlighted rows in different colors. Should demonstrate the core functionality. + +### Screenshot 2 (1280x800 or 640x400 pixels) +**Location:** `store-assets/screenshot-2.png` +**Description:** Options page showing the rule creation interface. Should show the form with example rules. + +### Screenshot 3 (1280x800 or 640x400 pixels) +**Location:** `store-assets/screenshot-3.png` +**Description:** (Optional) Close-up of highlighted emails showing different colors and rule types in action. + +### Screenshot 4 (1280x800 or 640x400 pixels) +**Location:** `store-assets/screenshot-4.png` +**Description:** (Optional) Example of OR pattern matching with multiple highlighted rows. + +**Note:** Chrome Web Store requires at least 1 screenshot, but up to 5 can be uploaded. Recommended: 2-3 screenshots. + +## Privacy Policy + +**Status:** Created in repository (`PRIVACY_POLICY.md`) + +**Action Required:** Host the privacy policy and add the URL to your Chrome Web Store listing. + +### Hosting Options + +You need to host the privacy policy at a publicly accessible URL. Here are some options: + +1. **GitHub Pages** (Recommended for open source projects) + - Enable GitHub Pages in your repository settings + - The privacy policy will be available at: `https://twhetzel.github.io/highlight-gmail/PRIVACY_POLICY.md` + - Or create a `docs/` folder and move it there for a cleaner URL + +2. **GitHub Raw URL** (Simple but less ideal) + - Use the raw file URL: `https://raw.githubusercontent.com/twhetzel/highlight-gmail/main/PRIVACY_POLICY.md` + - Note: This shows the raw markdown, not a formatted page + +3. **Simple Website** + - Host on any web hosting service + - Convert markdown to HTML if desired + +4. **Privacy Policy Generator** + - Use a service like [Privacy Policy Generator](https://www.privacypolicygenerator.info/) + - Host the generated HTML page + +**Privacy Policy URL:** (Add your hosted URL here) +``` +https://twhetzel.github.io/highlight-gmail/PRIVACY_POLICY.md +``` + +**Note:** Chrome Web Store requires a privacy policy URL if your extension uses the storage permission and stores user data. Since this extension stores highlight rules, a privacy policy is recommended. + +## Support Information + +**Support URL:** (Optional - can link to GitHub issues or support page) +``` +mailto:support@t2labs.org +``` + +**Homepage URL:** (Optional - can link to GitHub repo or project page) +``` +https://github.com/twhetzel/highlight-gmail +``` + +## Additional Store Listing Fields + +### Single Purpose +**Yes** - The extension has a single purpose: highlighting Gmail rows based on user-defined rules. + +### Content Rating +**Everyone** - No mature content, appropriate for all ages. + +### Permissions Justification +**Storage Permission:** +Used to save and sync highlight rules across devices. All data is stored locally in Chrome's sync storage. + +**Host Permission (mail.google.com):** +Required to inject the content script that highlights email rows in Gmail. + +### Collection of User Data +**No** - The extension does not collect, transmit, or share any user data. + +### Offline Capability +**Yes** - The extension works offline once rules are configured, as all processing happens locally. + +## Version History Notes + +### Version 1.0.1 +- Initial release +- Highlight emails by sender, subject, or label +- Custom colors for each rule +- OR pattern matching with comma-separated patterns +- Enable/disable rules +- Real-time updates + +## Keywords/Tags (for SEO) + +- gmail +- email +- highlight +- productivity +- inbox +- organization +- rules +- filter +- color +- gmail extension +- email management + +## Store Listing Checklist + +- [ ] Name matches manifest.json +- [ ] Short description is within 132 characters +- [ ] Detailed description is complete and formatted +- [ ] Category selected (Productivity) +- [ ] At least 1 screenshot uploaded (recommended: 2-3) +- [ ] Promotional images created (optional but recommended) +- [ ] Privacy policy URL added (required if collecting data) +- [ ] Support URL added (optional) +- [ ] Homepage URL added (optional) +- [ ] Permissions justified +- [ ] Single purpose declared +- [ ] Content rating set +- [ ] Version history notes added + +## Notes + +- Keep the detailed description updated when adding new features +- Screenshots should be clear and demonstrate the extension's value +- Promotional images are optional but can improve visibility +- Privacy policy is required if the extension collects any user data (this extension doesn't, but it's good practice to have one) +- Update version history notes with each release diff --git a/store-assets/README.md b/store-assets/README.md new file mode 100644 index 0000000..251fcc6 --- /dev/null +++ b/store-assets/README.md @@ -0,0 +1,94 @@ +# Store Assets Directory + +This directory contains assets for the Chrome Web Store listing. + +## Required Assets + +### Screenshots +- **Minimum:** 1 screenshot required +- **Recommended:** 2-3 screenshots +- **Maximum:** 5 screenshots +- **Dimensions:** 1280x800 or 640x400 pixels +- **Format:** PNG or JPEG + +**Screenshot Ideas:** +1. `screenshot-1.png` - Gmail inbox with highlighted rows showing different colors +2. `screenshot-2.png` - Options page with rule creation interface +3. `screenshot-3.png` - Close-up of highlighted emails with different rule types +4. `screenshot-4.png` - Example of OR pattern matching in action + +### Promotional Images (Optional but Recommended) + +#### Small Promotional Tile +- **File:** `promotional-small.png` +- **Dimensions:** 440x280 pixels +- **Format:** PNG or JPEG +- **Purpose:** Shown in Chrome Web Store listings + +#### Large Promotional Tile +- **File:** `promotional-large.png` +- **Dimensions:** 920x680 pixels +- **Format:** PNG or JPEG +- **Purpose:** Shown on the extension's store page + +#### Marquee Promotional Tile (Optional) +- **File:** `promotional-marquee.png` +- **Dimensions:** 1400x560 pixels +- **Format:** PNG or JPEG +- **Purpose:** For featured placement in Chrome Web Store + +## Design Guidelines + +### Screenshots +- Show the extension in action +- Use clear, readable text +- Highlight the main features +- Keep Gmail UI visible to show context +- Use different colors to demonstrate customization +- Avoid cluttered or confusing layouts + +### Promotional Images +- Include the extension name: "Gmail Row Highlighter" +- Show key features visually +- Use colors that match the extension's branding +- Keep text minimal and readable +- Make it visually appealing and professional + +## Creating Screenshots + +1. Install the extension in Chrome +2. Set up example rules with different colors +3. Open Gmail and navigate to your inbox +4. Take screenshots showing: + - Highlighted email rows + - Options page with rules + - Different rule types in action +5. Crop and resize to required dimensions +6. Save as PNG or JPEG in this directory + +## Creating Promotional Images + +Use design tools like: +- Figma +- Canva +- Photoshop +- GIMP + +Include: +- Extension name +- Key value proposition +- Visual example (can use screenshots as reference) +- Clean, professional design + +## File Naming Convention + +- Screenshots: `screenshot-1.png`, `screenshot-2.png`, etc. +- Promotional: `promotional-small.png`, `promotional-large.png`, `promotional-marquee.png` + +## Notes + +- All images should be optimized for web (reasonable file size) +- Use PNG for images with text or sharp edges +- Use JPEG for photos or images with gradients +- Keep file sizes reasonable (under 1MB per image when possible) +- Test images look good at the required dimensions