@ckeditor/vite-plugin-ckeditor5

CKEditor 5 Vite plugin

Integrate the CKEditor 5's build process in your Vite setup.

⚠️ Experimental feature

Using this plugin to build CKEditor 5 from source in Vite is still in the experimental phase. We encourage you to test it and give us feedback. However, there might be some issues in more complex application/usecases, thus using this solution in production applications is not yet recommended.

Usage

You should use this plugin when building CKEditor 5 from source in a Vite application. It handles loading the .svg icons and styles from the packages and theme package. If your editor is already built (e.g you downloaded it from CKEditor 5 Online Builder) then this plugin is not needed.

1. Install the package.

npm install -D @ckeditor/vite-plugin-ckeditor5 # or yarn add -D @ckeditor/vite-plugin-ckeditor5

1. Import and use the plugin in Vite configuration.

// vite.config.js import { defineConfig } from 'vite'; import ckeditor5 from '@ckeditor/vite-plugin-ckeditor5'; export default defineConfig( { plugins: [ ckeditor5( { theme: require.resolve( '@ckeditor/ckeditor5-theme-lark' ) } ) ] } );

Options:

theme

This should be an absolute path to the main file in theme package. Example:

{ theme: require.resolve( '@ckeditor/ckeditor5-theme-lark' ) }

Note: If you are using this plugin in an ESM project you may encounter an error stating that require.resolve is not a function. In this case you can add the following to the top of your vite.config.js file:

import { createRequire } from 'node:module'; const require = createRequire( import.meta.url );

Known issues

• This plugin will not emit any translation files and only english is currently supported.
• When using the Export to Word or Export to PDF plugins the editor styles will not be automatically collected.

Releasing package

Changelog

Before starting the release process, you need to generate the changelog:

npm run changelog

Publishing

After generating the changelog, you are able to release the package.

First, you need to bump the version:

npm run release:bump-version

You can also use the --dry-run option in order to see what this task does.

After bumping the version, you can publish the changes:

npm run release:publish

As in the previous task, the --dry-run option is also available.

Note: Only the dist/ directory will be published.

License

Licensed under the terms of GNU General Public License Version 2 or later. For full details about the license, please check the LICENSE.md file.