create-extension-factory

CLI tool to quickly scaffold a new browser extension project with Extension Factory.

Usage

With npx (recommended)

npx create-extension-factory my-extension

With npm

npm create extension-factory my-extension

With pnpm

pnpm create extension-factory my-extension

With yarn

yarn create extension-factory my-extension

Interactive Mode

If you don't provide a project name, the CLI will prompt you for:

• Project name
• Description
• Author
• Package manager (npm/pnpm/yarn)
• Whether to install dependencies

Options

create-extension-factory [project-name] [options]

Options

• -t, --template <template> - Template to use (default: react)
• -h, --help - Display help
• -V, --version - Display version

Templates

Currently available templates:

• react - React + TypeScript + Extension.js

What's Included

The generated project includes:

• ✨ Extension.js setup for browser extension development
• ⚛️ React + TypeScript
• 🔐 Subscription management (Lemon Squeezy + 爱发电)
• 🌍 i18n support with react-i18next
• 🎨 Pre-configured UI components from @extension-factory/ui-core
• 📦 Business logic from @extension-factory/business-core
• 🚀 Ready-to-use popup and options pages

Project Structure

my-extension/
├── src/
│   ├── popup.tsx          # Popup page
│   ├── options.tsx        # Options page
│   ├── background.ts      # Background service worker
│   ├── config/
│   │   └── subscription.ts # Subscription configuration
│   └── i18n.ts           # i18n setup
├── public/
│   ├── popup.html
│   └── options.html
├── extension.config.js    # Extension.js configuration
├── package.json
└── tsconfig.json

Next Steps

After creating your project:

cd my-extension

# Start development mode
npm run dev

# Build for production
npm run build

# Load the extension in Chrome
npm start

Configuration

Edit src/config/subscription.ts to configure:

• Feature flags for each subscription tier
• Usage quotas
• Payment provider credentials (Lemon Squeezy, 爱发电)

Learn More

• Extension Factory Documentation
• Extension.js Documentation

License

MIT