专注构建浏览器产品, 而不是重复造脚手架。
MkExtension 是一套可用于生产环境的 WXT + React 模板,预置浏览器各类入口、Better Auth 集成、类型安全消息、共享存储、国际化、主题和跨浏览器交付流程。
- 开源项目
- Chrome 与 Firefox
- 面向生产环境
侧边栏
MkExtension
扩展 Popup
默认采用现代技术栈
面向生产环境,并且已经协同工作。
精选经过验证的工具,覆盖浏览器 UI、类型安全、样式、身份认证和服务端状态。
快速开始
几分钟内,从克隆仓库到运行扩展。
从第一次本地运行到最终生成浏览器商店安装包,项目结构和命令始终清晰可预测。
变成你的产品
从仓库开始,用 Bun 安装依赖,只保留产品真正需要的扩展入口。
连接并定制
配置后端地址,定制共享 UI,并通过 WXT 快速重载运行 Chrome 或 Firefox。
构建并发布
在本地生成 Chrome 和 Firefox Zip,或使用内置的 GitHub Actions 工作流发布。
$ bun install
$ cp .env.example .env
$ bun run dev:chrome
✓ Extension ready at build/chrome-mv3
开箱即用
核心创意之外的基础工作,都已经准备好。
从 UI、认证、状态、消息、国际化到跨浏览器构建和交付,浏览器产品所需的通用基础能力都遵循同一套清晰结构。
常用扩展入口全部预置
Popup、设置页、侧边栏、新标签页、DevTools、内容脚本、后台 Worker 和认证页面都可以直接定制。
Chrome 与 Firefox
使用同一套 WXT 代码构建 Chrome Manifest V3 和 Firefox 扩展包。
灵活的后端认证
将邮箱或 Google OAuth 接入任意兼容 Better Auth 的后端,不绑定某一个网站模板。
类型安全消息与存储
通过 WXT Storage 共享浏览器状态,并使用类型安全消息在不同扩展上下文之间通信。
国际化与主题
内置中英文词典、浏览器语言检测、运行时切换,以及浅色、深色和跟随系统主题。
可靠的发布流程
TypeScript 检查、Biome、GitHub Actions、Zip 构建和可选商店提交已经串联完成。
一套代码,覆盖所有入口
在用户真正工作的地方提供产品能力。
根据不同任务选择最适合的浏览器入口。MkExtension 让入口保持轻量,并共享组件、认证、存储和消息基础设施。
Popup
在紧凑的工具栏窗口中提供高频快捷操作。
侧边栏
让产品常驻网页旁边,同时保持用户当前的工作流。
设置页
为偏好设置和产品配置提供更宽敞的操作空间。
新标签页
把每次打开的新标签页变成完整、专注的产品空间。
DevTools
在浏览器开发者工具中加入自定义工具和面板。
内容脚本
通过隔离的 React 界面增强用户正在访问的网页。
后台 Worker
运行事件驱动的浏览器逻辑,协调不同扩展上下文。
扩展页面
承载登录、引导或其他由扩展拥有的完整页面。
自带后端
连接任意兼容 Better Auth 的后端。
MkExtension 不绑定某一个 SaaS 模板。无论后端是 MkFast、MkSaaS、TanStack Start、Next.js,还是其他提供 Better Auth 会话与 API 的兼容框架,都可以接入。
- Bearer 会话通过 WXT Storage 安全持久化。
- 邮箱和 Google OAuth 已适配浏览器 identity 回调流程。
- 继续使用现有的后端、数据库、支付和业务逻辑。
你的网站应用
Better Auth + API
MkExtension
已认证的浏览器扩展