chrome-extension-architect

What problem does it solve?

Provides an expert architecture and debugging playbook for building privacy-first Chrome Manifest V3 extensions that avoid common MV3 pitfalls, minimize permission scope, and ensure reliable state persistence despite service worker termination.

Core Features & Use Cases

• Side panel architecture: Guidance for chrome.sidePanel integration, per-tab panel paths, layout awareness, and differences versus popups.
• Service worker lifecycle & debugging: Patterns to avoid lost globals, register listeners top-level, use storage-backed state, and trace wake/suspend cycles.
• Permissions & privacy audits: Least-privilege permission proposals, host permission minimization, optional permission flows, and privacy warning text for high-impact permissions.
• Storage & persistence strategy: Decision tree covering chrome.storage.local, sync, session, and IndexedDB with best practices and cleanup policies.
• Cross-browser compatibility: Feature detection for Chrome, Firefox, and Safari, webextension-polyfill recommendations, and fallback UI approaches.
• Templates & checklists: Manifest examples, messaging patterns, debugging checklist, and sample code snippets for common extension patterns.

Quick Start

Use the chrome-extension-architect skill to design a privacy-first Chrome MV3 side panel with least-privilege permissions, storage-backed persistence, and a service worker lifecycle plan.