npm - @hienlh/ppm - Versions diffs - 0.9.79 → 0.9.81 - Mend

@hienlh/ppm 0.9.79 → 0.9.81

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 (1661) hide show

package/.opencode/skills/seo/references/core-web-vitals-remediation.md ADDED Viewed

@@ -0,0 +1,279 @@
+# Core Web Vitals Remediation
+## LCP (Largest Contentful Paint) - Target < 2.5s
+### Common Causes
+- Large unoptimized images
+- Slow server response time (TTFB)
+- Render-blocking CSS/JS
+- Client-side rendering delays
+### Fixes
+**1. Image Optimization**
+```html
+<!-- Before -->
+<img src="hero.jpg" alt="Hero">
+<!-- After -->
+<img
+  src="hero.webp"
+  alt="Hero"
+  width="1200"
+  height="600"
+  loading="eager"
+  fetchpriority="high"
+>
+```
+**2. Preload Critical Assets**
+```html
+<head>
+  <!-- Preload LCP image -->
+  <link rel="preload" as="image" href="hero.webp" fetchpriority="high">
+  <!-- Preload critical fonts -->
+  <link rel="preload" href="/fonts/inter.woff2" as="font" type="font/woff2" crossorigin>
+</head>
+```
+**3. Optimize Server Response (TTFB)**
+```javascript
+// Use CDN for static assets
+// Enable HTTP/2 or HTTP/3
+// Implement caching headers
+app.use((req, res, next) => {
+  res.setHeader('Cache-Control', 'public, max-age=31536000, immutable');
+  next();
+});
+```
+**4. Remove Render-Blocking Resources**
+```html
+<!-- Defer non-critical CSS -->
+<link rel="preload" href="styles.css" as="style" onload="this.onload=null;this.rel='stylesheet'">
+<noscript><link rel="stylesheet" href="styles.css"></noscript>
+<!-- Defer JavaScript -->
+<script src="app.js" defer></script>
+```
+**5. Lazy Load Below-Fold Images**
+```html
+<img
+  src="placeholder.jpg"
+  data-src="full-image.webp"
+  loading="lazy"
+  alt="Description"
+>
+```
+## FID/INP (Interaction to Next Paint) - Target < 200ms
+### Common Causes
+- Heavy JavaScript execution
+- Long tasks (>50ms)
+- Event handler delays
+- Third-party scripts
+### Fixes
+**1. Code Splitting**
+```javascript
+// Before: Large bundle
+import { heavyFunction } from './heavy-module';
+// After: Dynamic import
+const handleClick = async () => {
+  const { heavyFunction } = await import('./heavy-module');
+  heavyFunction();
+};
+```
+**2. Debounce Input Handlers**
+```javascript
+// Debounce search input
+const debounce = (fn, delay) => {
+  let timeout;
+  return (...args) => {
+    clearTimeout(timeout);
+    timeout = setTimeout(() => fn(...args), delay);
+  };
+};
+input.addEventListener('input', debounce(handleSearch, 300));
+```
+**3. Use Web Workers for Heavy Tasks**
+```javascript
+// worker.js
+self.addEventListener('message', (e) => {
+  const result = heavyComputation(e.data);
+  self.postMessage(result);
+});
+// main.js
+const worker = new Worker('worker.js');
+worker.postMessage(data);
+worker.addEventListener('message', (e) => console.log(e.data));
+```
+**4. Optimize Event Handlers**
+```javascript
+// Use passive listeners for scroll/touch
+window.addEventListener('scroll', handleScroll, { passive: true });
+// Use event delegation
+container.addEventListener('click', (e) => {
+  if (e.target.matches('.button')) handleClick(e);
+});
+```
+**5. Minimize Third-Party Scripts**
+```html
+<!-- Load third-party scripts async -->
+<script src="analytics.js" async></script>
+<!-- Use facade pattern for heavy embeds -->
+<div class="youtube-facade" data-video-id="xyz">
+  <img src="thumbnail.jpg" alt="Video">
+  <button>Play</button>
+</div>
+```
+## CLS (Cumulative Layout Shift) - Target < 0.1
+### Common Causes
+- Images without dimensions
+- Ads/embeds without reserved space
+- Web fonts causing FOIT/FOUT
+- Dynamically injected content
+### Fixes
+**1. Set Image Dimensions**
+```html
+<!-- Always specify width/height -->
+<img
+  src="image.jpg"
+  width="800"
+  height="600"
+  alt="Description"
+>
+<!-- Or use aspect-ratio in CSS -->
+<style>
+.image-container {
+  aspect-ratio: 16 / 9;
+}
+</style>
+```
+**2. Reserve Space for Ads/Embeds**
+```css
+.ad-container {
+  min-height: 250px; /* Reserve space */
+  background: #f0f0f0;
+}
+.embed-container {
+  aspect-ratio: 16 / 9;
+  position: relative;
+}
+```
+**3. Optimize Font Loading**
+```css
+/* Use font-display: swap */
+@font-face {
+  font-family: 'Inter';
+  src: url('/fonts/inter.woff2') format('woff2');
+  font-display: swap; /* Prevent invisible text */
+}
+/* Or use fallback font metrics */
+@font-face {
+  font-family: 'Inter';
+  src: url('/fonts/inter.woff2') format('woff2');
+  size-adjust: 100%;
+  ascent-override: 90%;
+  descent-override: 22%;
+}
+```
+**4. Avoid Injecting Content Above Existing**
+```javascript
+// Bad: Prepends content
+container.prepend(newElement);
+// Good: Append or use placeholder
+container.append(newElement);
+// Or reserve space with skeleton
+<div class="skeleton" style="height: 200px;"></div>
+```
+**5. Use CSS Transforms for Animations**
+```css
+/* Bad: Triggers layout shift */
+.element {
+  animation: slide 0.3s ease;
+}
+@keyframes slide {
+  from { margin-left: 0; }
+  to { margin-left: 100px; }
+}
+/* Good: Uses transform */
+.element {
+  animation: slide 0.3s ease;
+}
+@keyframes slide {
+  from { transform: translateX(0); }
+  to { transform: translateX(100px); }
+}
+```
+## Testing Tools
+### API-Based (PageSpeed Insights)
+```bash
+node scripts/audit-core-web-vitals.cjs -u https://example.com
+```
+### Browser-Based (chrome-devtools skill)
+```bash
+cd .opencode/skills/chrome-devtools/scripts
+# Real browser CWV
+node performance.js --url https://example.com | jq '.vitals'
+# With trace for debugging
+node performance.js --url https://example.com --trace trace.json
+```
+See: `browser-seo-audit-workflow.md` for full workflow.
+### In-App Monitoring
+```javascript
+import {onLCP, onINP, onCLS} from 'web-vitals';
+onLCP(console.log);
+onINP(console.log);
+onCLS(console.log);
+```
+## Quick Wins Checklist
+- [ ] Add width/height to all images
+- [ ] Preload LCP image with fetchpriority="high"
+- [ ] Use font-display: swap for web fonts
+- [ ] Defer non-critical JavaScript
+- [ ] Lazy load below-fold images
+- [ ] Minify CSS/JS
+- [ ] Enable compression (gzip/brotli)
+- [ ] Use CDN for static assets
+- [ ] Reserve space for ads/embeds
+- [ ] Remove unused CSS/JS

package/.opencode/skills/seo/references/directory-submission-list.md ADDED Viewed

@@ -0,0 +1,280 @@
+# Directory Submission List
+## Submission Tracking Template
+```markdown
+| Directory | URL | Category | DA | Type | Submitted | Status | Link |
+|-----------|-----|----------|----| -----|-----------|--------|------|
+| [Name] | [URL] | [Category] | [DA] | [DoFollow/NoFollow] | [Date] | [Pending/Approved/Rejected] | [Your listing URL] |
+```
+## Top General Directories
+### High Authority (DA 80+)
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Crunchbase | crunchbase.com | 92 | DoFollow | Tech/startup focus, free listing |
+| Google Business Profile | google.com/business | 100 | NoFollow | Essential for local SEO |
+| Bing Places | bingplaces.com | 95 | NoFollow | Microsoft search visibility |
+| Yelp | yelp.com | 93 | NoFollow | Review-based, local focus |
+| Better Business Bureau | bbb.org | 91 | NoFollow | Trust signal, paid accreditation |
+| Yellow Pages | yellowpages.com | 89 | NoFollow | Traditional directory, local focus |
+### Quality General (DA 50-79)
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Hotfrog | hotfrog.com | 74 | DoFollow | International, business listings |
+| Brownbook | brownbook.net | 67 | DoFollow | Global directory, free listing |
+| Cylex | cylex.us.com | 65 | DoFollow | Local business, multiple countries |
+| Foursquare | foursquare.com | 93 | NoFollow | Location-based, review platform |
+| Manta | manta.com | 72 | NoFollow | B2B focused directory |
+| Merchant Circle | merchantcircle.com | 68 | NoFollow | Local business community |
+### Niche-Specific Opportunities (DA 40-70)
+## Tech & SaaS Directories
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Product Hunt | producthunt.com | 91 | DoFollow | Product launches, high engagement |
+| G2 | g2.com | 90 | NoFollow | Software reviews, strong authority |
+| Capterra | capterra.com | 88 | NoFollow | Software discovery, Gartner owned |
+| SaaSHub | saashub.com | 58 | DoFollow | SaaS alternatives, free listing |
+| AlternativeTo | alternativeto.net | 78 | DoFollow | Software alternatives directory |
+| Slashdot | slashdot.org | 86 | DoFollow | Tech news, accepts submissions |
+| StackShare | stackshare.io | 74 | DoFollow | Developer tools, tech stacks |
+| BetaList | betalist.com | 70 | DoFollow | Startup launches, early adopters |
+## Marketing & Agency Directories
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Clutch | clutch.co | 82 | NoFollow | B2B services, review-based |
+| Agency Spotter | agencyspotter.com | 61 | DoFollow | Marketing agency directory |
+| The Manifest | themanifest.com | 72 | NoFollow | B2B marketplace, research |
+| GoodFirms | goodfirms.co | 65 | DoFollow | IT/software/marketing firms |
+| DesignRush | designrush.com | 68 | DoFollow | Agency directory, awards |
+| SortList | sortlist.com | 59 | DoFollow | Agency matching platform |
+## E-commerce & Retail
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Shopify App Store | apps.shopify.com | 94 | NoFollow | Apps only, high conversion |
+| Amazon Seller Central | sellercentral.amazon.com | 100 | NoFollow | Marketplace, not directory |
+| Etsy | etsy.com | 93 | NoFollow | Handmade/vintage marketplace |
+| Houzz | houzz.com | 88 | NoFollow | Home improvement, design |
+## Local & Regional Directories
+### US Local
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Angi (Angie's List) | angi.com | 84 | NoFollow | Home services, review-based |
+| Thumbtack | thumbtack.com | 82 | NoFollow | Local services marketplace |
+| HomeAdvisor | homeadvisor.com | 80 | NoFollow | Home improvement pros |
+| Nextdoor Business | nextdoor.com/business | 91 | NoFollow | Hyperlocal, neighborhood focus |
+| Chamber of Commerce | uschamber.com | 89 | DoFollow | Local chambers, membership |
+| MapQuest | mapquest.com | 81 | NoFollow | Maps/directions, business listings |
+### Industry-Specific Local
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Healthgrades | healthgrades.com | 83 | NoFollow | Healthcare providers |
+| Avvo | avvo.com | 81 | NoFollow | Lawyers directory |
+| ZocDoc | zocdoc.com | 78 | NoFollow | Healthcare appointments |
+| TripAdvisor | tripadvisor.com | 93 | NoFollow | Travel, restaurants, hotels |
+| OpenTable | opentable.com | 86 | NoFollow | Restaurant reservations |
+## Niche Industry Directories
+### Design & Creative
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Behance | behance.net | 94 | NoFollow | Creative portfolio showcase |
+| Dribbble | dribbble.com | 93 | DoFollow | Design community, portfolio |
+| Awwwards | awwwards.com | 83 | DoFollow | Web design awards |
+| CSS Design Awards | cssdesignawards.com | 70 | DoFollow | Web design showcase |
+### Development & Open Source
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| GitHub | github.com | 100 | NoFollow | Code repositories, profiles |
+| Stack Overflow | stackoverflow.com | 97 | NoFollow | Developer Q&A, profiles |
+| Dev.to | dev.to | 82 | DoFollow | Developer community |
+| Hashnode | hashnode.com | 75 | DoFollow | Developer blogging |
+### Freelance & Gig Economy
+| Directory | URL | DA | Type | Notes |
+|-----------|-----|----| -----|-------|
+| Upwork | upwork.com | 90 | NoFollow | Freelance marketplace |
+| Fiverr | fiverr.com | 91 | NoFollow | Services marketplace |
+| Toptal | toptal.com | 81 | NoFollow | Elite freelancer network |
+| Freelancer | freelancer.com | 88 | NoFollow | Global freelance platform |
+## Submission Best Practices
+### Profile Optimization
+- **Business Name**: Consistent across all directories (NAP consistency)
+- **Description**: Unique 150-200 words per directory (avoid duplicate content)
+- **Categories**: Choose most relevant primary category
+- **Images**: Logo (square format), cover image (16:9), product shots
+- **Contact Info**: Complete all fields (phone, email, address, website)
+- **Social Links**: Add all relevant social profiles
+### NAP Consistency (Critical for Local SEO)
+```
+Name: [Exact business name]
+Address: [Exact format, including suite/unit]
+Phone: [Same format everywhere, e.g., (555) 123-4567]
+```
+### Description Templates
+**General Business** (150 words):
+```
+[Company Name] provides [primary service/product] for [target audience] in [location/industry]. Established in [year], we specialize in [key offering 1], [key offering 2], and [key offering 3].
+Our [unique value proposition] helps clients [main benefit]. We've served [X clients/customers] achieving [notable result or metric].
+Services include:
+- [Service 1]
+- [Service 2]
+- [Service 3]
+Contact us for [call-to-action] at [website] or [phone].
+```
+**SaaS/Tech Product** (150 words):
+```
+[Product Name] is a [category] platform that helps [target users] [main outcome].
+Key features:
+- [Feature 1]: [Benefit]
+- [Feature 2]: [Benefit]
+- [Feature 3]: [Benefit]
+Trusted by [X companies/users] including [notable customer if applicable]. [Product] integrates with [popular tools] and offers [pricing model].
+Try free at [website] or schedule demo.
+```
+### Submission Priority Framework
+**Tier 1 (Submit first)**:
+- DA 80+ directories
+- Industry-specific high-authority
+- Google Business Profile essential
+**Tier 2 (Next priority)**:
+- DA 60-79 general directories
+- Niche directories with DoFollow
+- Review platforms in your industry
+**Tier 3 (If time allows)**:
+- DA 40-59 directories
+- Location-specific local directories
+- Emerging niche platforms
+### Submission Workflow
+1. **Preparation** (1-2 hours):
+   - Gather assets (logos, images, descriptions)
+   - Standardize NAP information
+   - Create unique descriptions (5-10 variants)
+   - Prepare credentials list
+2. **Batch Submission** (2-3 hours):
+   - Submit to Tier 1 directories (1-2 hours)
+   - Document submission details in tracking sheet
+   - Save confirmation emails
+3. **Verification** (1 week):
+   - Check for verification emails
+   - Complete verification steps (phone, email, postcard)
+   - Update tracking sheet with status
+4. **Optimization** (Ongoing):
+   - Add photos to listings
+   - Respond to reviews
+   - Update business hours/info
+   - Monitor for spam edits
+### Tracking Spreadsheet Template
+```
+Directory Name | URL | Category | DA | Link Type | Priority | Date Submitted | Verification Status | Listing URL | Username | Password | Notes
+```
+### Red Flags to Avoid
+**Don't Submit To**:
+- Spam directories (100+ listings per page)
+- Irrelevant categories (damages relevance)
+- Paid-only with no value (just link farms)
+- Exact duplicate content across directories
+- Directories with no organic traffic
+- Sites with malware/security warnings
+### Quality Signals
+**Good Directories Have**:
+- Manual review process
+- Active moderation
+- Organic traffic (check Ahrefs/Semrush)
+- Clean, professional design
+- Engaged user base
+- Mobile-responsive site
+- SSL certificate
+- Reasonable submission requirements
+## Monitoring & Maintenance
+### Monthly Tasks
+- Check for unapproved submissions
+- Respond to new reviews
+- Update business information changes
+- Add new photos/content
+- Check for unauthorized edits
+### Quarterly Tasks
+- Audit all listings for accuracy
+- Remove/disavow spam directories
+- Analyze referral traffic from directories
+- Identify new directory opportunities
+- Update descriptions to avoid staleness
+### Annual Tasks
+- Comprehensive NAP audit
+- Refresh all photos and media
+- Rewrite descriptions (avoid duplicate content penalties)
+- Evaluate ROI of paid directories
+- Clean up outdated/closed directories
+## Tools for Directory Submission
+### Automation Tools
+- **Moz Local**: Automated US directory submission
+- **BrightLocal**: Citation building and tracking
+- **Yext**: Enterprise directory management
+- **Whitespark**: Local citation finder
+### Manual Tools
+- **Google Sheets**: Tracking template
+- **LastPass**: Password management
+- **Bulk Resize**: Image preparation
+- **Grammarly**: Description proofreading
+## Expected Results
+### Timeline
+- **Week 1-2**: Tier 1 submissions approved
+- **Month 1**: 50-70% of submissions live
+- **Month 3**: All submissions processed
+- **Month 6**: Measurable local SEO impact
+### Impact Metrics
+- **Local Pack Rankings**: Improved visibility in Google Maps
+- **Organic Traffic**: 5-10% lift from directory referrals
+- **Domain Authority**: 2-5 point increase over 6 months
+- **Brand Searches**: Increased branded search volume