wxt/docs/guide/configuration.md

Configuration

WXT's behavior can be configured via the wxt.config.ts file. In this file, you can add Vite plugins, change the directory strucutre of your project, and set fields on your manifest.json.

Config File

To configure WXT, create a wxt.config.ts file in your project root. It should have the following contents:

import { defineConfig } from 'wxt';

export default defineConfig({
  // My WXT config
});

:::info See the Config reference for a full list of options. :::

Directory Config

WXT allows you to edit several directories to your liking:

• root (default: process.cwd()) - Root of the WXT project
• srcDir (default: <rootDir>) - Location of all your source code
• entrypointsDir (default: <srcDir>/entrypoints) - Folder containing all the entrypoints.
• publicDir (default: <srcDir>/public) - Folder containing public assets

Example

You want a src/ directory to contain all your source code, and you want to rename entrypoints/ → entries/:

<rootDir>
├─ src/
│  └─ entries/
│     ├─ background.ts
│     └─ ...
└─ wxt.config.ts

Your config would look like this:

import { defineConfig } from 'wxt';

export default defineConfig({
  srcDir: 'src',
  entrypointsDir: 'entries',
});

Vite Config

Vite is the bundler used to build each entrypoint of your extension. Vite can be configured via the vite option.

See Vite's documentation for configuring the bundler.

Frontend Frameworks

Adding a framework like Vue, React, or Svelte is easy!

In the wxt.config.ts file, install and add the framework's Vite plugin to the config.

:::code-group

import { defineConfig } from 'wxt';
import vue from '@vitejs/plugin-vue';

export default defineConfig({
  vite: {
    plugins: [vue()],
  },
});

import { defineConfig } from 'wxt';
import react from '@vitejs/plugin-react';

export default defineConfig({
  vite: {
    plugins: [react()],
  },
});

import { defineConfig } from 'wxt';
import { svelte } from '@sveltejs/vite-plugin-svelte';

export default defineConfig({
  vite: {
    plugins: [svelte()],
  },
});

:::