vite-patcher

Inject Vite Plugins and related configurations without any effort into your vite.config.

vite-patcher is a CLI tool designed to automate the configuration of Vite plugins. It directly reads your Vite configuration file, applies necessary code injections (like adding imports and initializing plugins) while preserving your file's layout and formatting, and saves you from error-prone manual setup.

✨ Features

❯ Automated Configuration: Say goodbye to manual editing. Let the tool seamlessly inject plugin configurations into your vite.config.*. ❯ Smart Formatting: The tool respects your existing indentation (tabs vs spaces) and preserves standard quotes. ❯ Vike Integration: Detects when vike is included in your project and automatically handles edge cases (e.g., bypassing client/server double injection conflicts).

ℹ️ Supported Plugins

| Command | Plugin | Description | - | - | - | pwa | vite-plugin-pwa | Add Progressive Web App (PWA) support. Supports vike as well.

⚙️ Installation

Install exactly what you need for your local environment:

| Package Manager | Command | - | - | npm | npm install -D vite-patcher | yarn | yarn add -D vite-patcher | pnpm | pnpm add -D vite-patcher

📖 Usage

Run the CLI tool directly to apply patches to your Vite configuration.

pwa patch

Quickly inject vite-plugin-pwa into your existing vite.config:

| Package Manager | Command | - | - | npm | npm run vite-patcher pwa | yarn | yarn vite-patcher pwa | pnpm | pnpm vite-patcher pwa

Or execute via your package runner without installing as a permanent dependency (using npx/dlx):

| Package Manager | Command | - | - | npm | npx vite-patcher pwa | yarn | yarn dlx vite-patcher pwa | pnpm | pnpm dlx vite-patcher pwa

🛠️ Contributing

Got ideas or want to add a patch string?

1. Clone the repository.
2. Install dependencies with yarn install.
3. Build the project using yarn build (uses tsdown).
4. Run tests with yarn test.

📜 License

This project is licensed under the MIT License.