Feature chooser
| Goal | Start here |
|---|---|
| Ship one codebase to multiple browsers | Cross-browser compatibility |
| Handle browser-specific manifest differences | Browser-specific manifest fields |
| Keep non-manifest assets organized | Special folders |
| Manage environment-specific behavior | Environment variables |
| Centralize build/runtime defaults | Extension configuration |
| Extend bundler behavior safely | Rspack configuration |
| Understand update behavior in development mode | Page reload and hot module replacement (HMR) |
| Avoid path drift between source and output | Path resolution |
| Build and package for target matrices | Multi-platform builds |
| Review the telemetry privacy contract | Telemetry and privacy |
Recommended progression
- Validate browser output guarantees (
cross-browser-compatibility). - Lock project defaults (
extension-configuration). - Add advanced behavior (
rspack-configuration,environment-variables). - Optimize release flows (
multi-platform-builds).
Video walkthrough
Next steps
- Apply these capabilities in Workflows.
- Choose the right execution command in Commands reference.
- Review the privacy contract in Telemetry and privacy.

