README

Found this useful? Install from Packagist · Star the repo on GitHub.

Symfony bundle: Ckeditor5EditorType stores HTML in a textarea while CKEditor 5 classic (GPL open-source plugins only) runs in the browser. YAML profiles (FOS-style), Vite IIFE build (ckeditor5-editor.js) under src/Resources/public/.

FrankenPHP worker mode: Supported for production-style demo runs (worker-enabled Caddyfile). Development demos use classic php_server without worker so PHP/Twig changes apply on refresh — see docs/DEMO-FRANKENPHP.md.

Features

• Named YAML profiles (toolbar, min_height, form_theme, preset, theme, optional upload_url).
• Twig themes for common layouts (Bootstrap 3–5, Foundation, Tailwind 2, table layout).
• nowo_ckeditor5_editor_asset_path() and nowo_ckeditor5_editor_asset_package() Twig helpers for published assets (Symfony asset package).
• pnpm + Vite frontend; Vitest coverage on shared utilities (logger.ts).
• Dockerfile + Makefile aligned with other Nowo bundles.
• Demos: Symfony 7.4 and 8.1 FrankenPHP apps under demo/ (ports 8020 / 8021).

Requirements

Composer constraints: ^6.4 \|\| ^7.0 \|\| ^8.0 on Symfony components. See INSTALLATION.md.

Quick start

composer require nowo-tech/ckeditor5-editor-bundle:^1.0
php bin/console assets:install public

# config/packages/nowo_ckeditor5_editor.yaml
nowo_ckeditor5_editor:
    default_config: simple
    configs:
        simple:
            preset: simple
            toolbar: true
            min_height: 240px
            form_theme: form_div_layout.html.twig
            debug: false
            theme: light

use Nowo\Ckeditor5EditorBundle\Form\Ckeditor5EditorType;

$builder->add('body', Ckeditor5EditorType::class, [
    'label' => 'Article body',
]);

<script src="{{ asset(nowo_ckeditor5_editor_asset_path('ckeditor5-editor.js'), nowo_ckeditor5_editor_asset_package()) }}"></script>

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development

Additional documentation

• Demo with FrankenPHP (development and production)

Development

Requirements: Docker (recommended), or PHP 8.2+ with Composer + pnpm locally.

make up && make install   # Docker PHP + composer + pnpm
make assets               # vite → src/Resources/public/ckeditor5-editor.js
make test                 # PHPUnit
make test-ts              # Vitest + coverage script
make qa                   # cs-check + phpunit

Demos:

make -C demo up-symfony8
# http://localhost:8021 (see demo/README.md and PORT in .env)

Presets include standard, simple, minimal, emoji, typography, variables — see USAGE.md.

Tests and coverage

CI runs PHPUnit (matrix PHP 8.2–8.5 × Symfony 7.0 / 7.4 / 8.0 / 8.1), PHPStan, PHP-CS-Fixer dry-run, and Vitest coverage on pushes and pull requests.

License

MIT (bundle code). CKEditor 5 is used under its GPL / LGPL / commercial terms — this build uses OSS plugins suitable for GPL-compatible apps.