Easy Browser Extension Starter

A production-capable React and TypeScript foundation for cross-browser extensions.

Documentation · Discussions · Issues

“What do we build for, if not to lessen each other’s hardship?”

Important

This repository is currently in the foundation stage. Do not treat it as production-ready until the first stable release.

Best for

• Popup, options, side-panel, and new-tab extensions
• Content-script page enhancements
• Productivity and AI assistant extensions
• Chrome, Edge, and Firefox releases from one codebase

Not for: Ordinary websites or products that do not need browser-extension APIs.

Baseline

• Extension.js, React, and TypeScript
• Background, content, popup, options, and shared boundaries
• Permission-minimization and secure messaging conventions
• Browser-specific development and production packaging
• Testing, CI, agent rules, specs, and release guidance

Quick start

Preferred:

fonij create my-product

Direct template use:

gh repo create my-product --template FonijBuild/easy-browser-extension-starter --private --clone
cd my-product
cp .env.example .env.local
pnpm install
pnpm dev

Project contract

• .fonij/starter.json describes this foundation to Fonij.
• AGENTS.md defines repository rules for AI coding agents.
• specs/ contains implementation-ready feature specifications.
• docs/ contains architecture and repository-specific guidance.
• Keep quality checks green before merging changes.

Contributing

Read CONTRIBUTING.md before contributing. Security issues must follow SECURITY.md.