npm - @mytechtoday/augment-extensions - Versions diffs - 0.4.0 → 0.7.0 - Mend

@mytechtoday/augment-extensions 0.4.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (226) hide show

package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/email-marketing.md ADDED Viewed

@@ -0,0 +1,439 @@
+# Email Marketing Standards
+## Overview
+Best practices for email marketing including subject lines, responsive HTML design, deliverability, CAN-SPAM compliance, and email automation strategies.
+---
+## Subject Line Best Practices
+### Length and Format
+- **Optimal length**: 40-50 characters (mobile preview)
+- **Desktop preview**: ~60 characters
+- **Mobile preview**: ~30-40 characters
+### Writing Techniques
+**DO**:
+- Use personalization (`{{FirstName}}`, location, company)
+- Create urgency ("Last chance", "Ending soon")
+- Ask questions ("Ready to boost your sales?")
+- Use numbers ("5 ways to...", "Save 20%")
+- Test emojis (use sparingly, A/B test)
+- Be specific and clear about email content
+**DON'T**:
+- Use ALL CAPS or excessive punctuation!!!
+- Overuse spam trigger words (FREE, URGENT, ACT NOW)
+- Mislead about email content (clickbait)
+- Use "Re:" or "Fwd:" deceptively
+- Overuse emojis (looks unprofessional)
+### Subject Line Formulas
+**Curiosity**: "You won't believe what happened..."
+**Urgency**: "Only 3 hours left to save 30%"
+**Personalization**: "{{FirstName}}, your exclusive offer inside"
+**Question**: "Struggling with email deliverability?"
+**How-to**: "How to double your email open rates"
+**List**: "7 email marketing mistakes to avoid"
+### A/B Testing
+**Test Variables**:
+- Personalization vs. generic
+- Question vs. statement
+- Short vs. long
+- Emoji vs. no emoji
+- Urgency vs. value-focused
+**Sample Size**: Minimum 1,000 recipients per variant
+---
+## Email Design and HTML
+### Responsive Design
+**Mobile-First Approach**:
+- 60%+ of emails opened on mobile
+- Single-column layout for mobile
+- Minimum font size: 14px (16px for body text)
+- Touch-friendly buttons: 44x44 pixels minimum
+- Optimize images for mobile (max 600px width)
+### HTML Email Structure
+**Best Practices**:
+- Use table-based layout (better email client support)
+- Inline CSS (many clients strip `<style>` tags)
+- Set width to 600-650px (desktop standard)
+- Use web-safe fonts (Arial, Georgia, Times New Roman, Verdana)
+- Include alt text for all images
+- Use background colors (not background images)
+**Example Template**:
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Email Title</title>
+</head>
+<body style="margin: 0; padding: 0; font-family: Arial, sans-serif;">
+  <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+    <tr>
+      <td align="center" style="padding: 20px 0;">
+        <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px;">
+          <!-- Header -->
+          <tr>
+            <td style="padding: 20px; background-color: #f8f8f8;">
+              <img src="logo.png" alt="Company Logo" width="150" style="display: block;">
+            </td>
+          </tr>
+          <!-- Body -->
+          <tr>
+            <td style="padding: 40px 20px; background-color: #ffffff;">
+              <h1 style="margin: 0 0 20px; font-size: 24px; color: #333333;">Email Headline</h1>
+              <p style="margin: 0 0 20px; font-size: 16px; line-height: 1.6; color: #666666;">
+                Email body content goes here.
+              </p>
+              <!-- CTA Button -->
+              <table role="presentation" cellspacing="0" cellpadding="0" border="0">
+                <tr>
+                  <td style="border-radius: 4px; background-color: #007bff;">
+                    <a href="https://example.com" target="_blank" style="display: inline-block; padding: 14px 28px; font-size: 16px; color: #ffffff; text-decoration: none; font-weight: bold;">
+                      Click Here
+                    </a>
+                  </td>
+                </tr>
+              </table>
+            </td>
+          </tr>
+          <!-- Footer -->
+          <tr>
+            <td style="padding: 20px; background-color: #f8f8f8; font-size: 12px; color: #999999; text-align: center;">
+              <p style="margin: 0 0 10px;">Company Name | Address | Phone</p>
+              <p style="margin: 0 0 10px;">
+                <a href="{{UnsubscribeLink}}" style="color: #007bff; text-decoration: underline;">Unsubscribe</a>
+              </p>
+            </td>
+          </tr>
+        </table>
+      </td>
+    </tr>
+  </table>
+</body>
+</html>
+```
+### Design Elements
+**Colors**:
+- Use brand colors consistently
+- Ensure sufficient contrast (WCAG AA: 4.5:1 for text)
+- Limit to 2-3 colors per email
+**Images**:
+- Optimize file size (< 100KB per image)
+- Use alt text (many clients block images by default)
+- Don't rely solely on images for message
+- Use PNG for logos, JPG for photos
+**CTAs (Call-to-Action)**:
+- Use button, not just text link
+- Make it stand out (contrasting color)
+- Use action-oriented text ("Get Started", "Download Now")
+- Limit to 1-2 CTAs per email
+- Place primary CTA above the fold
+---
+## Email Deliverability
+### Authentication
+**SPF (Sender Policy Framework)**:
+```
+v=spf1 include:_spf.google.com ~all
+```
+**DKIM (DomainKeys Identified Mail)**:
+- Add DKIM signature to email headers
+- Verify domain ownership
+**DMARC (Domain-based Message Authentication)**:
+```
+v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com
+```
+### Sender Reputation
+**Best Practices**:
+- Use consistent "From" name and email
+- Warm up new IP addresses gradually
+- Maintain low bounce rate (< 2%)
+- Keep spam complaint rate low (< 0.1%)
+- Remove inactive subscribers (no opens in 6+ months)
+- Use double opt-in for new subscribers
+### Avoiding Spam Filters
+**DO**:
+- Use reputable ESP (Email Service Provider)
+- Authenticate your domain (SPF, DKIM, DMARC)
+- Maintain clean email list
+- Include physical mailing address
+- Provide easy unsubscribe option
+- Balance text-to-image ratio (60/40)
+**DON'T**:
+- Use spam trigger words excessively
+- Send from free email providers (Gmail, Yahoo)
+- Use misleading subject lines
+- Send to purchased lists
+- Send too frequently (causes unsubscribes)
+- Use URL shorteners (looks suspicious)
+---
+## CAN-SPAM Compliance
+### Required Elements
+**1. Accurate Header Information**:
+- "From", "To", "Reply-To" must be accurate
+- Routing information must identify sender
+**2. Non-Deceptive Subject Lines**:
+- Subject line must reflect email content
+- No misleading or false information
+**3. Identify Message as Advertisement**:
+- Clearly disclose if email is promotional
+- Can be in subject line or body
+**4. Include Physical Address**:
+- Valid physical postal address
+- Can be street address or P.O. box
+**5. Provide Opt-Out Method**:
+- Clear and conspicuous unsubscribe link
+- Process opt-outs within 10 business days
+- Honor opt-out for at least 30 days
+**6. Monitor Third-Party Senders**:
+- You're responsible even if you hire someone else
+- Monitor compliance of email marketing vendors
+### Penalties
+- Up to $46,517 per violation
+- Criminal penalties for egregious violations
+---
+## Email Automation and Workflows
+### Welcome Series
+**Trigger**: New subscriber
+**Sequence**:
+1. **Email 1** (Immediate): Welcome + deliver lead magnet
+2. **Email 2** (Day 2): Introduce brand story and values
+3. **Email 3** (Day 4): Showcase best content/products
+4. **Email 4** (Day 7): Social proof (testimonials, case studies)
+5. **Email 5** (Day 10): Special offer or CTA
+### Abandoned Cart Series
+**Trigger**: User adds to cart but doesn't complete purchase
+**Sequence**:
+1. **Email 1** (1 hour): Reminder with cart contents
+2. **Email 2** (24 hours): Add urgency (limited stock, expiring discount)
+3. **Email 3** (48 hours): Offer incentive (free shipping, discount)
+### Re-Engagement Campaign
+**Trigger**: No opens in 90+ days
+**Sequence**:
+1. **Email 1**: "We miss you" + highlight new content/products
+2. **Email 2** (7 days later): Special "come back" offer
+3. **Email 3** (14 days later): Final chance + confirm subscription preference
+### Drip Campaigns
+**Educational Drip**:
+- Send valuable content over time
+- Build trust and authority
+- Nurture leads toward purchase
+**Onboarding Drip**:
+- Help new customers get started
+- Reduce churn
+- Increase product adoption
+---
+## Segmentation and Personalization
+### Segmentation Criteria
+**Demographics**:
+- Age, gender, location
+- Job title, industry, company size
+**Behavioral**:
+- Purchase history
+- Email engagement (opens, clicks)
+- Website activity
+- Product interests
+**Lifecycle Stage**:
+- Subscriber (not yet customer)
+- First-time customer
+- Repeat customer
+- VIP/high-value customer
+- Churned customer
+### Personalization Tactics
+**Basic**:
+- Use first name in subject line and greeting
+- Reference location or company
+- Send from a real person (not "noreply@")
+**Advanced**:
+- Dynamic content blocks based on interests
+- Product recommendations based on browsing history
+- Send time optimization (when user typically opens)
+- Personalized subject lines based on behavior
+---
+## Email Types and Frequency
+### Newsletter
+**Purpose**: Regular updates, content roundup
+**Frequency**: Weekly or bi-weekly
+**Content**: Blog posts, news, tips, curated content
+### Promotional
+**Purpose**: Drive sales, announce offers
+**Frequency**: 1-2 per week (max)
+**Content**: Product launches, discounts, limited-time offers
+### Transactional
+**Purpose**: Order confirmations, receipts, shipping updates
+**Frequency**: As needed (triggered)
+**Content**: Purchase details, tracking info, account updates
+### Lifecycle
+**Purpose**: Nurture leads, onboard customers
+**Frequency**: Automated sequence
+**Content**: Educational content, product tips, case studies
+---
+## Metrics and KPIs
+### Key Metrics
+**Open Rate**:
+- Formula: (Emails opened / Emails delivered) × 100
+- Benchmark: 15-25% (varies by industry)
+- Factors: Subject line, sender name, send time
+**Click-Through Rate (CTR)**:
+- Formula: (Clicks / Emails delivered) × 100
+- Benchmark: 2-5%
+- Factors: Email content, CTA placement, relevance
+**Click-to-Open Rate (CTOR)**:
+- Formula: (Clicks / Opens) × 100
+- Benchmark: 10-15%
+- Measures email content effectiveness
+**Conversion Rate**:
+- Formula: (Conversions / Emails delivered) × 100
+- Benchmark: 1-5% (varies by goal)
+- Ultimate measure of email success
+**Bounce Rate**:
+- Hard bounces: Invalid email addresses (remove immediately)
+- Soft bounces: Temporary issues (full inbox, server down)
+- Target: < 2%
+**Unsubscribe Rate**:
+- Formula: (Unsubscribes / Emails delivered) × 100
+- Benchmark: < 0.5%
+- High rate indicates poor targeting or frequency
+**List Growth Rate**:
+- Formula: [(New subscribers - Unsubscribes) / Total subscribers] × 100
+- Target: 2-5% per month
+---
+## Best Practices Summary
+### DO
+✅ Personalize subject lines and content
+✅ Optimize for mobile devices
+✅ Segment your email list
+✅ A/B test subject lines and content
+✅ Include clear, compelling CTAs
+✅ Maintain consistent sending schedule
+✅ Monitor deliverability metrics
+✅ Comply with CAN-SPAM and GDPR
+### DON'T
+❌ Buy email lists
+❌ Send without permission (opt-in)
+❌ Use deceptive subject lines
+❌ Forget to include unsubscribe link
+❌ Send too frequently
+❌ Ignore mobile optimization
+❌ Use image-only emails
+❌ Neglect email authentication (SPF, DKIM, DMARC)
+---
+## Tools and Resources
+### Email Service Providers (ESPs)
+- **Mailchimp**: Beginner-friendly, free tier available
+- **Constant Contact**: Small business focused
+- **HubSpot**: All-in-one marketing platform
+- **ActiveCampaign**: Advanced automation
+- **SendGrid**: Developer-friendly, transactional emails
+- **ConvertKit**: Creator-focused
+### Testing and Optimization
+- **Litmus**: Email testing across clients
+- **Email on Acid**: Email rendering and spam testing
+- **Mail Tester**: Spam score checker
+- **Really Good Emails**: Design inspiration
+### Learning Resources
+- **Really Good Emails**: Email design examples
+- **Email Marketing Rules**: CAN-SPAM compliance guide
+- **Litmus Blog**: Email marketing best practices
+- **Campaign Monitor Resources**: Email marketing guides

package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/legal-compliance.md ADDED Viewed

@@ -0,0 +1,227 @@
+# Legal Compliance Standards
+## Overview
+Guidelines for ensuring marketing content complies with FTC, CAN-SPAM, GDPR, WCAG, and other legal requirements.
+---
+## FTC Guidelines (Federal Trade Commission)
+### Disclosure Requirements
+**Sponsored Content**:
+- Clearly label sponsored posts with "Sponsored", "Ad", or "Paid Partnership"
+- Place disclosure above the fold, before "Read More" links
+- Use clear, unambiguous language (not just #ad or #sponsored)
+**Affiliate Links**:
+- Disclose affiliate relationships before links
+- Use language like "This post contains affiliate links"
+- Make disclosure visible and understandable
+**Endorsements and Testimonials**:
+- Disclose material connections (payment, free products, relationships)
+- Ensure testimonials reflect typical results or include disclaimer
+- Don't use fake reviews or testimonials
+### Example Disclosures
+```markdown
+**Disclosure**: This post contains affiliate links. We may earn a commission if you make a purchase through these links at no additional cost to you.
+**Sponsored**: This content is sponsored by [Brand Name]. All opinions are our own.
+```
+---
+## CAN-SPAM Act (Email Marketing)
+### Required Elements
+1. **Accurate Header Information**:
+   - From, To, Reply-To must be accurate
+   - Subject line must reflect email content
+   - No deceptive routing information
+2. **Clear Identification as Advertisement**:
+   - Label promotional emails clearly
+   - Use "Advertisement" or "Promotional" in subject or body
+3. **Physical Postal Address**:
+   - Include valid physical postal address
+   - Can be street address or P.O. Box
+4. **Unsubscribe Mechanism**:
+   - Provide clear, conspicuous unsubscribe link
+   - Process opt-outs within 10 business days
+   - Don't require login to unsubscribe
+   - Don't charge fees for unsubscribing
+5. **Honor Opt-Outs Promptly**:
+   - Stop sending emails within 10 business days
+   - Don't sell or transfer email addresses of opt-outs
+### Email Footer Template
+```html
+<footer>
+  <p>You're receiving this email because you subscribed to our newsletter.</p>
+  <p><a href="{{unsubscribe_link}}">Unsubscribe</a> | <a href="{{preferences_link}}">Update Preferences</a></p>
+  <p>{{Company Name}}<br>
+  {{Street Address}}<br>
+  {{City, State ZIP}}</p>
+</footer>
+```
+---
+## GDPR (General Data Protection Regulation)
+### Consent Requirements
+**Explicit Consent**:
+- Use clear, affirmative action (checkbox, button)
+- Don't use pre-checked boxes
+- Separate consent for different purposes
+- Provide granular control (email, SMS, phone)
+**Consent Language**:
+```html
+<label>
+  <input type="checkbox" name="marketing_consent" required>
+  I consent to receive marketing emails from [Company]. I understand I can withdraw consent at any time.
+</label>
+```
+### Data Processing Transparency
+**Privacy Policy Must Include**:
+- What data is collected
+- How data is used
+- Who data is shared with
+- How long data is retained
+- User rights (access, deletion, portability)
+### User Rights
+1. **Right to Access**: Provide data upon request
+2. **Right to Erasure**: Delete data upon request ("right to be forgotten")
+3. **Right to Portability**: Export data in machine-readable format
+4. **Right to Rectification**: Correct inaccurate data
+### Cookie Consent
+```html
+<div class="cookie-banner">
+  <p>We use cookies to improve your experience. By continuing, you consent to our use of cookies.</p>
+  <button onclick="acceptCookies()">Accept</button>
+  <button onclick="rejectCookies()">Reject</button>
+  <a href="/privacy-policy">Learn More</a>
+</div>
+```
+---
+## WCAG 2.1 AA (Web Content Accessibility Guidelines)
+### Color Contrast Requirements
+- **Normal Text**: Minimum 4.5:1 contrast ratio
+- **Large Text** (18pt+ or 14pt+ bold): Minimum 3:1 contrast ratio
+- **Interactive Elements**: Minimum 3:1 contrast ratio
+**Tools**: WebAIM Contrast Checker, Chrome DevTools
+### Keyboard Navigation
+- All interactive elements accessible via keyboard
+- Visible focus indicators (outline, border, background change)
+- Logical tab order (left-to-right, top-to-bottom)
+- Skip navigation links for screen readers
+### Alternative Text
+**Images**:
+```html
+<img src="product.jpg" alt="Blue running shoes with white laces">
+```
+**Decorative Images**:
+```html
+<img src="decoration.jpg" alt="" role="presentation">
+```
+**Complex Images** (charts, diagrams):
+- Provide detailed description in adjacent text or `<figcaption>`
+### Semantic HTML
+```html
+<!-- DO -->
+<nav>
+  <ul>
+    <li><a href="/">Home</a></li>
+  </ul>
+</nav>
+<!-- DON'T -->
+<div class="nav">
+  <div class="link" onclick="navigate()">Home</div>
+</div>
+```
+---
+## Copyright and Trademark Usage
+### Copyright
+- **Original Content**: Automatically copyrighted upon creation
+- **Attribution**: Credit sources when using others' content
+- **Fair Use**: Limited use for commentary, criticism, education
+- **Licensing**: Respect Creative Commons and other licenses
+### Trademarks
+- Use ™ for unregistered trademarks
+- Use ® for registered trademarks
+- Don't use competitors' trademarks in misleading ways
+- Follow brand guidelines when mentioning other brands
+---
+## Privacy Policy Requirements
+### Essential Sections
+1. **Information Collection**: What data is collected (name, email, IP, cookies)
+2. **Use of Information**: How data is used (marketing, analytics, personalization)
+3. **Data Sharing**: Third parties with access (analytics, email providers)
+4. **Data Security**: How data is protected (encryption, secure servers)
+5. **User Rights**: How to access, modify, delete data
+6. **Contact Information**: How to reach privacy officer
+---
+## Compliance Checklist
+Before publishing marketing content:
+- [ ] **FTC**: Disclosures for sponsored content and affiliate links
+- [ ] **CAN-SPAM**: Unsubscribe link, physical address, accurate headers
+- [ ] **GDPR**: Explicit consent, privacy policy link, data rights
+- [ ] **WCAG**: 4.5:1 color contrast, alt text, keyboard navigation
+- [ ] **Copyright**: Proper attribution for images and quotes
+- [ ] **Trademarks**: Correct usage of ™ and ® symbols
+---
+## Resources
+- **FTC**: [ftc.gov/business-guidance](https://www.ftc.gov/business-guidance)
+- **CAN-SPAM**: [ftc.gov/can-spam](https://www.ftc.gov/tips-advice/business-center/guidance/can-spam-act-compliance-guide-business)
+- **GDPR**: [gdpr.eu](https://gdpr.eu/)
+- **WCAG**: [w3.org/WAI/WCAG21/quickref](https://www.w3.org/WAI/WCAG21/quickref/)
+- **Accessibility Testing**: WebAIM, WAVE, axe DevTools