PHPackages                             besmartand-pro/tiptap-editor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. besmartand-pro/tiptap-editor

ActiveSymfony-bundle

besmartand-pro/tiptap-editor
============================

Reusable Symfony Tiptap editor bundle with optional EasyAdmin integration and Flysystem uploads.

1.0.5(1w ago)034proprietaryPHPPHP ^8.3CI passing

Since Apr 8Pushed 1w agoCompare

[ Source](https://github.com/BeSmartAnd-Pro/tiptap-editor)[ Packagist](https://packagist.org/packages/besmartand-pro/tiptap-editor)[ RSS](/packages/besmartand-pro-tiptap-editor/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (14)Versions (8)Used By (0)

BeSmartAnd.Pro Tiptap Editor Bundle
===================================

[](#besmartandpro-tiptap-editor-bundle)

Reusable Symfony bundle with a compact Tiptap-based editor for classic Symfony forms and optional EasyAdmin integration.

It ships with:

- `BeSmartAndPro\TiptapEditorBundle\Form\Type\TiptapType`
- `BeSmartAndPro\TiptapEditorBundle\EasyAdmin\Field\TiptapField`
- a Stimulus controller namespace: `besmartand-pro--tiptap-editor`
- a compact icon-based toolbar with hover tooltips
- optional image uploads, including drag and drop and paste from clipboard

Requirements
------------

[](#requirements)

- PHP `^8.3`
- Symfony `^7.4`
- `symfony/stimulus-bundle`
- a frontend build using Encore or Vite
- these frontend packages in the host app:
    - `@tiptap/core`
    - `@tiptap/starter-kit`
    - `@tiptap/extension-image`
    - `@tiptap/extension-link`
    - `@tiptap/extension-placeholder`
    - `@tiptap/extension-strike`
    - `@tiptap/extension-underline`
    - `bootstrap-icons`

Installation
------------

[](#installation)

```
composer require besmartand-pro/tiptap-editor
php bin/console besmartand-pro:tiptap-editor:install
```

Then refresh frontend dependencies with your package manager:

```
pnpm install
```

or:

```
npm install
```

or:

```
yarn install
```

What The Install Command Does
-----------------------------

[](#what-the-install-command-does)

`php bin/console besmartand-pro:tiptap-editor:install` is the "make it work in a real app" step.

It will:

- check whether `symfony/stimulus-bundle` is installed
- inspect `package.json`
- add missing Tiptap and `bootstrap-icons` dependencies
- detect `webpack.config.js` or `vite.config.*`
- create `assets/controllers/besmartand_pro/tiptap_editor_controller.ts`
- create `assets/styles/besmartand_pro_tiptap_editor.scss`
- try to import the stylesheet into a likely frontend entry file
- scaffold `config/packages/besmartand_pro_tiptap_editor.yaml`
- scaffold `config/routes/besmartand_pro_tiptap_editor.yaml`

The generated frontend files are copied into the host app instead of importing TS or SCSS through `vendor/`, which keeps both Vite and Encore builds stable.

If your project layout is unusual, the copied asset files are still enough to wire things manually.

Symfony Flex
------------

[](#symfony-flex)

This bundle is ready for a Symfony Flex recipe, but Flex should be treated as the first half of the setup, not the whole installer.

Recommended approach:

- Flex recipe copies config, routes and asset bridge files into the host app
- the bundle install command finishes the smart bits like dependency checks and frontend entry imports

The included `flex-recipe/` directory is a starter recipe template for publishing to your own Flex recipes repository or to `symfony/recipes-contrib`.

Encore
------

[](#encore)

The install command will try to add:

```
import './styles/besmartand_pro_tiptap_editor.scss';
```

to a likely entry file such as `assets/admin.ts` or `assets/app.ts`.

Your Stimulus bootstrap should keep scanning `assets/controllers`.

The bundle stylesheet imports Bootstrap Icons using:

```
@import "bootstrap-icons/font/bootstrap-icons.css";
```

This works with Vite and with current Encore/Webpack setups. Legacy `~bootstrap-icons/...` imports can still exist in host applications if their loader configuration supports them, but the bundle itself uses the bundler-neutral form so it can build cleanly in both environments.

Vite
----

[](#vite)

The install command will try to add the same stylesheet import to a likely Vite entry such as `assets/main.ts` or `assets/app.ts`.

Your Stimulus bootstrap should still expose controllers from `assets/controllers`.

If you installed an older bundle version that generated `vendor/...` bridge imports, rerun:

```
php bin/console besmartand-pro:tiptap-editor:install
```

The installer will replace those legacy bridge files with local copied assets that Vite can build reliably.

Uploads
-------

[](#uploads)

Uploads are optional.

If upload config is missing or disabled:

- the editor still works
- image upload buttons are hidden
- drag and drop image uploads are disabled
- paste-from-clipboard uploads are disabled

Example with Oneup Flysystem:

```
besmartand_pro_tiptap_editor:
    default_placeholder: 'Wpisz treść...'
    upload:
        enabled: true
        filesystem_service: 'oneup_flysystem.images_filesystem'
        public_url_prefix: '/cdn/images'
        security_attribute: 'ROLE_ADMIN'
        max_file_size: 8388608
```

The configured service only needs to expose `writeStream()`, so any Flysystem-compatible filesystem service is enough.

Usage
-----

[](#usage)

### Symfony Form

[](#symfony-form)

```
use BeSmartAndPro\TiptapEditorBundle\Form\Type\TiptapType;

$builder->add('content', TiptapType::class, [
    'tiptap_placeholder' => 'Wpisz treść...',
]);
```

### EasyAdmin

[](#easyadmin)

```
use BeSmartAndPro\TiptapEditorBundle\EasyAdmin\Field\TiptapField;

yield TiptapField::new('content', 'Treść')
    ->setPlaceholder('Wpisz treść...');
```

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance96

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

6

Last Release

10d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a5eda0ea76c039a15c99f60bda898bbeec9d55fec934633e8a16b97de296bef?d=identicon)[roszkiewiczjakub](/maintainers/roszkiewiczjakub)

---

Top Contributors

[![jroszkiewicz](https://avatars.githubusercontent.com/u/2973897?v=4)](https://github.com/jroszkiewicz "jroszkiewicz (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

### Embed Badge

![Health badge](/badges/besmartand-pro-tiptap-editor/health.svg)

```
[![Health](https://phpackages.com/badges/besmartand-pro-tiptap-editor/health.svg)](https://phpackages.com/packages/besmartand-pro-tiptap-editor)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.3k](/packages/contao-core-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
