vite-plugin-keep
is a Vite plugin that allows you to specify a source directory to be copied into your build directory upon successful build completion. This is particularly useful for including assets or other files that need to be part of the output but are not directly imported in your source code.
- Easy to Use: Simply specify the source and destination directories.
- Customizable: Flexible source and destination paths.
- Efficient: Uses
fs-extra
for fast and reliable file copying.
Install the plugin with npm:
npm install vite-plugin-keep --save-dev
Or with yarn:
yarn add vite-plugin-keep --dev
To use vite-plugin-keep
, import it into your Vite configuration file and add it to the plugins array. You need to specify the src
and dest
options.
For ES Module (ESM) syntax:
// vite.config.js (ESM)
import vitePluginKeep from 'vite-plugin-keep';
export default {
plugins: [
vitePluginKeep({
src: 'path/to/source', // Source directory to be copied
dest: 'path/to/destination' // Destination directory in the build folder
})
]
}
For CommonJS (CJS) syntax:
// vite.config.js (CJS)
const vitePluginKeep = require('vite-plugin-keep');
module.exports = {
plugins: [
vitePluginKeep({
src: 'path/to/source',
dest: 'path/to/destination'
})
]
}
The plugin accepts an options object with the following properties:
- src: (string) The path to the source directory that you want to keep.
- dest: (string) The path to the destination directory where the source directory will be copied. This path is relative to the project's build output directory.
If you have a directory named static
in your project root that you want to copy to the assets
directory in your build output, you would configure the plugin like this:
vitePluginKeep({
src: 'static',
dest: 'assets'
})
This project is licensed under the MIT License.
Contributions are welcome. Please open an issue or submit a pull request with any improvements or suggestions.