Voorbereiding & Analyse (Strapi v5)

[AliKdhim87]

Omschrijving

Dit ticket is bedoeld om de huidige Strapi dashboards PDC en VTH te controleren.
We kijken alleen naar community (third-party) plugins die worden gebruikt.

Het doel is om te controleren of deze plugins werken met Strapi v5 en Node.js v22, en om mogelijke problemen vast te leggen.
Custom plugins uit onze monorepo vallen buiten de scope van dit ticket.

---

Taken

• Overzicht maken van alle community plugins in PDC en VTH
• Controleren of community plugins werken met Strapi v5
• Controleren van compatibiliteit met Node.js v22 en pnpm
• Bekende breaking changes per plugin opzoeken
• Problemen met Strapi v5 vaststellen
• Nodige aanpassingen per plugin opschrijven
• Community plugins indelen op complexiteit en impact

---

Acceptatiecriteria

• Alle community plugins van PDC en VTH zijn in kaart gebracht
• Compatibiliteit met Strapi v5 is gecontroleerd
• Bekende problemen en aanpassingen zijn gedocumenteerd
• Er is een duidelijke prioriteit voor de community plugins

[Marwaxhello]

Evaluatie van Community Plugins voor Strapi 5

In dit document wordt beschreven welke community-plugins geschikt zijn voor gebruik binnen Strapi 5, gebaseerd op onderzoek en tests uitgevoerd tijdens de migratie. Per plugin is beoordeeld of deze compatibel is met Strapi 5, welke issues zijn aangetroffen en welke mogelijke alternatieven beschikbaar zijn. Zowel een korte, niet-technische samenvatting als een uitgebreide analyse zijn opgenomen.

Overzicht Community Plugins – Strapi 5

✅ Config Sync

Config Sync werkt goed in Strapi 5 en kan zonder problemen worden gebruikt.

De plugin maakt het mogelijk om configuratie-instellingen te exporteren en te beheren in bestanden, wat handig is voor versiebeheer en samenwerking.

• ✅ Volledig compatibel met Strapi 5
• ✅ Werkt met Node 22 en pnpm
• ✅ Succesvol getest in een Strapi 5 sandbox
• ✅ Stabiel en betrouwbaar in gebruik

Conclusie:

Config Sync is een veilige en aanbevolen plugin voor Strapi 5 projecten.

---

✅ Publisher

De Publisher-plugin werkt correct en stabiel in Strapi 5 zonder extra aanpassingen.
Een plugin voor Strapi die de mogelijkheid biedt om het publiceren en de-publiceren van elk contenttype eenvoudig in te plannen.

• ✅ Volledig compatibel met Strapi 5
• ✅ Geen build errors
• ✅ Werkt met Node 22 en pnpm
• ✅ Eenvoudige setup

Conclusie:

De Publisher-plugin is veilig en aanbevolen voor Strapi 5. Een eenvoudige, stabiele plugin die direct waarde toevoegt zonder risico’s.

---

✅ Prometheus

De Prometheus-plugin werkt correct in Strapi 5 en is specifiek gebouwd voor deze versie.
De plugin wordt actief onderhouden en is geschikt voor het verzamelen van metrics voor monitoring en observability.

• ✅ Compatibel met Strapi 5
• ✅ Actief onderhouden
• ✅ Geschikt voor productiegebruik
• ✅ Compatibel met Node 22 en pnpm

Conclusie

De Prometheus-plugin is volledig compatibel met Strapi 5 en geschikt voor professioneel gebruik.
Voor projecten die monitoring nodig hebben, is dit een betrouwbare en toekomstvaste keuze.

---

❌ Entity Relationship Chart

De Entity Relationship Chart-plugin kan niet worden gebruikt in Strapi 5.

De plugin is gebouwd voor oudere Strapi-versies en loopt vast bij het build-proces van Strapi 5.

• ❌ Niet compatibel met Strapi 5
• ❌ Plugin start niet, build faalt
• 🛑 Geen actieve Strapi 5-ondersteuning

❌ Nadelen

• Werkt niet met Strapi 5
• Geen update beschikbaar die compatibiliteit herstelt
• Blokkeert strapi build
• Geen bruikbare fallback binnen Strapi zelf

✅ Voordelen (in Strapi 4)

• Visuele ER-diagrammen in de admin
• Handig overzicht van content-types en relaties

🔁 Alternatieven

Omdat er geen Strapi 5-compatibel alternatief bestaat:

• DBeaver – automatisch ER-diagram vanuit database
• dbdiagram.io – handmatig maar snel en overzichtelijk
• Draw.io / Lucidchart – documentatie-gericht

⚠️ Disclaimer – alternatieven

De onderstaande tools zijn geen officiële Strapi-plugins en niet door ons geverifieerd binnen Strapi 5.
Ze worden onderhouden door externe partijen of individuele ontwikkelaars en bieden geen garanties op volledigheid, ondersteuning of toekomstige compatibiliteit.

Conclusie

De Entity Relationship Chart-plugin is niet geschikt voor Strapi 5. Voor datamodellering en documentatie zijn externe tools noodzakelijk.

---

❌ Import Export Entries

De Import/Export Entries-plugin kan niet worden gebruikt in Strapi 5.

De plugin is gebouwd voor oudere Strapi-versies en maakt gebruik van onderdelen die in Strapi 5 zijn verwijderd.

• ❌ Niet compatibel met Strapi 5
• ❌ Admin build faalt
• 🛑 Plugin wordt niet actief onderhouden voor Strapi 5

❌ Nadelen

• Werkt niet in Strapi 5
• Werkt ook niet met alle Strapi 4-versies (laatste versies worden niet meer ondersteund)
• Blokkeert strapi build
• Gebruikt verouderde Strapi-packages
• Geen officiële upgrade of migratie beschikbaar

✅ Voordelen (alleen Strapi 4)

• Importeren en exporteren van content
• Handig voor content migraties
• Populaire community-plugin in Strapi 4

🔁 Mogelijke alternatieven

Plugin: strapi-import-export

⚠️ Disclaimer – alternatieven

Deze plugin is niet door ons geverifieerd in Strapi 5.

Het is een community-plugin, ontwikkeld en onderhouden door externe partijen. Het is beperkt getest, heeft minder adoptie, en biedt geen garanties op stabiliteit, onderhoud of langdurige ondersteuning.

Conclusie

De Import/Export Entries-plugin is onbruikbaar in Strapi 5.
Er bestaat een mogelijke alternatieve plugin, maar deze is niet officieel gevalideerd en moet eerst zorgvuldig worden getest voordat deze in productie wordt gebruikt.

---

❌ Notes

De Notes-plugin kan niet betrouwbaar worden gebruikt in Strapi 5.
De plugin is ontwikkeld voor oudere Strapi-versies en sluit niet goed aan op de veranderingen in Strapi 5, wat kan leiden tot instabiliteit in het admin panel.

• ❌ Niet compatibel met Strapi 5
• ⚠️ Onstabiel gedrag in de admin interface
• 🛑 Geen actieve ondersteuning voor Strapi 5

❌ Nadelen

• Onbetrouwbaar in Strapi 5
• Kan admin errors veroorzaken
• Niet geschikt voor productiegebruik
• Geen duidelijke upgrade-strategie

✅ Voordelen (alleen Strapi 4)

• Notities toevoegen aan content items
• Handig voor interne samenwerking
• Eenvoudig in gebruik

🔁 Mogelijke alternatieven

• Gebruik van externe tools zoals Notion, Jira of comments buiten Strapi
• Vastleggen van notities via custom fields binnen content-types
• Ontwikkelen van een custom plugin of het aanpassen (clonen) van een bestaande plugin zodat deze compatibel wordt met Strapi 5

⚠️ Disclaimer – alternatieven

De genoemde alternatieven zijn geen officiële vervanging voor de Notes-plugin in Strapi 5.
Ze bieden deels vergelijkbare functionaliteit, maar geen volledige 1-op-1 oplossing.
Het ontwikkelen of aanpassen van een custom oplossing vereist extra ontwikkeltijd en onderhoud, en moet afzonderlijk worden afgewogen.

Conclusie

De Notes-plugin is niet geschikt voor gebruik in Strapi 5. Voor teams wordt geadviseerd om gebruik te maken van externe samenwerkingstools of, indien noodzakelijk, te investeren in een custom oplossing die aansluit op Strapi 5.

---

❌ Slugify

De Slugify-plugin kan niet correct worden gebruikt in Strapi 5.
Tijdens het build-proces ontstaan errors, waardoor de applicatie niet kan starten.

• ❌ Niet compatibel met Strapi 5
• ❌ Build faalt
• 🛑 Geen officiële Strapi 5 ondersteuning

❌ Nadelen

• Werkt niet in Strapi 5
• Blokkeert strapi build
• Gebruikt verouderde dependencies
• Geen officiële Strapi 5-ondersteuning

✅ Voordelen (alleen Strapi 4)

• Automatisch genereren van slugs
• Consistente URL-structuur
• Veel gebruikt in Strapi 4 projecten

✅ Wat Strapi 5 wél biedt

Strapi 5 bevat standaard ondersteuning voor slug-velden, maar:

• Slugs moeten handmatig worden aangemaakt of beheerd
• Geen automatische generatie zoals de Slugify-plugin bood
• Minder gebruiksvriendelijk voor redacteurs

🔁 Mogelijke alternatieven

• Gebruik de ingebouwde slug-velden van Strapi 5 (handmatig)
• Evalueren of extra automatisering echt nodig is
• Indien gewenst: later kijken naar een custom oplossing

⚠️ Disclaimer – alternatieven

Alternatieven zijn custom oplossingen en geen kant-en-klare plugin-vervanging. Implementatie vereist extra ontwikkeling en testing.

Conclusie

De Slugify-plugin is onbruikbaar in Strapi 5. Aanbevolen wordt om slugs via custom code of Strapi lifecycles te beheren.

[Marwaxhello]

Technische Evaluatie Community Plugins – Strapi 5

✅ Config Sync

Strapi plugin

Summary

Hoewel veel community-plugins die voor Strapi 4 zijn gemaakt niet compatibel zijn met Strapi 5, werkt strapi-plugin-config-sync correct in Strapi 5 wanneer een compatibele versie wordt gebruikt.

✅ Config Sync - COMPATIBLE

Package: strapi-plugin-config-sync

Status: Werkt in Strapi 5

Marketplace: https://market.strapi.io/plugins/strapi-plugin-config-sync

Installatie stappen:

pnpm install strapi-plugin-config-sync --save

Configuratie:

Update config/admin.ts:

export default ({ env }) => ({
  // existing config
  watchIgnoreFiles: ['**/config/sync/**'],
});

Build & Start:

pnpm run build
pnpm run develop

COMPATIBLE met pnpm en node 22 ✅

Verificatie:

• ✅ Plugin zichtbaar onder Settings in admin panel
• ✅ Initial export succesvol (~40 config changes gedetecteerd)
• ✅ Config files gegenereerd in /config/sync

---

✅ Publisher

Strapi plugin

Summary

Hoewel veel community-plugins die voor Strapi 4 zijn gemaakt niet compatibel zijn met Strapi 5, werkt strapi-plugin-publisher correct in Strapi 5 zonder aanvullende aanpassingen.

✅ Publisher – COMPATIBLE

Package: strapi-plugin-publisher

Status: Werkt in Strapi 5

Marketplace: https://market.strapi.io/plugins/strapi-plugin-publisher

Installatie stappen

pnpm install strapi-plugin-publisher --save

Configuratie

Update config/plugins.ts (Strapi 5 – TypeScript):

exportdefault () => ({
publisher: {
enabled:true,
  },
});

Build & Start

pnpm run build
pnpm run develop

COMPATIBLE met pnpm en node 22 ✅

Verificatie

• ✅ Plugin zichtbaar in het admin panel
• ✅ Publiceer-/unpublish-functionaliteit beschikbaar op content entries
• ✅ Geen build errors tijdens admin build
• ✅ Werkt zonder extra workarounds of patches

---

✅ Prometheus

Strapi plugin

Summary

Hoewel de Config Sync-plugin officieel compatibel is met Strapi 5, kan Strapi niet starten wanneer de plugin is geconfigureerd maar niet daadwerkelijk is geïnstalleerd. Strapi 5 vereist strikte consistentie tussen config/plugins.ts en de geïnstalleerde dependencies; een ontbrekende plugin die wel in de configuratie staat resulteert in een harde startup-fout.

✅ Prometheus – COMPATIBLE

Package: strapi-prometheus

Versie: 2.x.x

Status: Werkt in Strapi 5

Marketplace / Repo: https://market.strapi.io/plugins/strapi-prometheus

Installatie stappen

pnpm add strapi-prometheus prom-client

Configuratie

config/plugins.ts (Strapi 5 – TypeScript):

exportdefault {
prometheus: {
enabled:true,
config: {
collectDefaultMetrics:false,
server: {
port:9000,
host:'0.0.0.0',
path:'/metrics',
      },
    },
  },
};

Build & Start

pnpm run build
pnpm run develop

Verificatie

• ✅ Plugin initialiseert correct in Strapi 5
• ✅ Metrics beschikbaar via http://localhost:9000/metrics
• ✅ Ondersteunt Vite + ESM admin build
• ✅ Actief onderhouden (recent bijgewerkt)
• ✅ Specifiek ontworpen voor Strapi 5 (v2.x)

---

❌ Entity Relationship Chart

Strapi plugin

Summary

De Entity Relationship Chart-plugin kan niet worden gebruikt in Strapi 5 vanwege een incompatibiliteit met het nieuwe admin-buildsysteem (Vite + ESM).

❌ Entity Relationship Chart - INCOMPATIBLE

Package: strapi-plugin-entity-relationship-chart

Versie: 4.14.6

Status: Werkt NIET in Strapi 5

Source: https://www.npmjs.com/package/strapi-plugin-entity-relationship-chart

Installatie stappen:

pnpm install strapi-plugin-entity-relationship-chart --save

Build & Start:

pnpm run build
pnpm run develop

COMPATIBILITY met pnpm en node 22 niet getest door error ⚠️

Error:

[commonjs--resolver] Expression expected
.../admin/src/components/PluginIcon/index.js:10
const PluginIcon = () => <OneToMany />;

Error waaneer npm run build / strapi build wordt uitgevoerd.

Root cause:

• Strapi 5 gebruikt Vite + ESM (niet meer Webpack)
• JSX in node_modules wordt niet meer automatisch getranspileerd
• Plugin bevat raw JSX in .js bestanden die Vite niet kan verwerken
• Dit werkte in Strapi 4, maar breekt in Strapi 5

Andere Plugin Alternatives?

Voor Strapi 5 is er geen goede plugin replacement voor ER diagrams. Gebruik externe tools zoals DBeaver voor automatische generatie of dbdiagram.io voor snelle manual diagrams.

---

❌ Import Export Entries

Strapi plugin

Summary

De Import/Export Entries-plugin kan niet worden gebruikt in Strapi 5 omdat het package @strapi/helper-plugin is verwijderd/deprecated in Strapi 5, wat resulteert in Rollup resolve errors tijdens de admin build.

❌ Import Export Entries - INCOMPATIBLE

Package: strapi-plugin-import-export-entries

Versie: 1.23.1

Status: Werkt NIET in Strapi 5

Source: https://www.npmjs.com/package/strapi-plugin-import-export-entries

Installatie stappen:

pnpm install strapi-plugin-import-export-entries

Configuratie:

Update config/admin.ts:

module.exports = ({ env }) => ({
  //...
  'import-export-entries': {
    enabled: true,
    config: {
      // See `Config` section.
    },
  },
  //...
});

Build & Start:

pnpm run build
pnpm run develop

COMPATIBILITY met pnpm en node 22 niet getest door error ⚠️

Error:

[vite]: Rollup failed to resolve import "@strapi/helper-plugin" from 
"node_modules/strapi-plugin-import-export-entries/admin/src/index.js"

This is most likely unintended because it can break your application at runtime.
If you do want to externalize this module explicitly add it to
`build.rollupOptions.external`

Root cause:

Strapi 5 breaking change:

• @strapi/helper-plugin is deprecated/removed in Strapi 5
• Plugin imports from dit package: import { ... } from '@strapi/helper-plugin'
• Vite/Rollup kan deze dependency niet resolven tijdens build

In Strapi 5:

• Helper functies zijn verplaatst naar @strapi/strapi/admin
• Of naar specifieke packages zoals @strapi/design-system

Andere Plugin Alternatives?

https://market.strapi.io/plugins/strapi-import-export

⚠️ Disclaimer – alternatieven

Deze plugin is niet door ons geverifieerd in Strapi 5.
Het is een community-plugin, ontwikkeld en onderhouden door externe partijen. Het is beperkt getest, heeft minder adoptie, en biedt geen garanties op stabiliteit, onderhoud of langdurige ondersteuning.

---

❌ Notes

Strapi plugin

Summary

De Notes-plugin kan niet probleemloos worden gebruikt in Strapi 5 vanwege TypeScript- en dependency-issues tijdens de build. De plugin introduceert indirect een dependency op minimatch, waarvoor de bijbehorende type-definities ontbreken, wat resulteert in een TypeScript build error.

❌ Notes – INCOMPATIBLE

Package: strapi-plugin-notes

Versie: 1.1.3

Status: Werkt NIET stabiel in Strapi 5

Source: https://github.com/strapi-community/strapi-plugin-notes

Installatie stappen:

pnpm install strapi-plugin-notes

Configuratie:

Update config/plugins:

module.exports = ({ env }) => ({
	'entity-notes': {
		enabled: true,
	},
});

Build & Start:

pnpm run build
pnpm run develop

INCOMPATIBLE met pnpm en node 22 ❌

Error

TS2688: Cannot findtype definition filefor'minimatch'.
The file isin the program because:
Entry pointfor implicittype library'minimatch'

Root cause

Strapi 5 + TypeScript stricter build

• Strapi 5 gebruikt een striktere TypeScript-configuratie

• De plugin (of een dependency daarvan) gebruikt minimatch zonder correcte typings

• TypeScript verwacht expliciet:

  @types/minimatch

• Zonder deze types faalt de admin build

---

❌ Slugify

Strapi plugin

Summary

De Slugify-plugin (strapi-plugin-slugify) kan niet worden gebruikt in Strapi 5. Tijdens de build treedt een TypeScript-error op doordat de plugin (of een dependency daarvan) indirect afhankelijk is van minimatch, waarvoor geen type-definities beschikbaar zijn. Door de strengere TypeScript-configuratie in Strapi 5 faalt hierdoor de admin build.

❌ Slugify – INCOMPATIBLE

Package: strapi-plugin-slugify

Versie: 2.3.8

Status: Werkt NIET in Strapi 5

Marketplace: https://market.strapi.io/plugins/strapi-plugin-slugify

Installatie stappen:

pnpm install strapi-plugin-notes

Configuratie:

Update config/admin.ts:

module.exports = ({ env }) => ({
	'entity-notes': {
		enabled: true,
	},
});

Build & Start:

pnpm run build
pnpm run develop

COMPATIBILITY met pnpm en node 22 niet getest door error ⚠️

Error

error TS2688: Cannot findtype definition filefor'minimatch'.
The file isin the program because:
  Entry pointfor implicittype library'minimatch'

Daarnaast:

WARN Unsupported engine: wanted: {"node":"24.12.0"}
(current: {"node":"v22.14.0","pnpm":"10.23.0"})

Root cause

Strapi 5 breaking changes

• Strapi 5 gebruikt een striktere TypeScript build

• Impliciete type libraries zonder expliciete typings veroorzaken build failures

• De plugin (of een transitive dependency) gebruikt minimatch zonder:

  @types/minimatch

Plugin is niet Strapi-5-ready

• Ontwikkeld voor Strapi 4
• Niet getest of aangepast voor:
  • TypeScript strict mode
  • Nieuwe admin build pipeline (Vite + ESM)

Conclusie

• ❌ strapi-plugin-slugify is niet compatibel met Strapi 5
• Build faalt zonder handmatige ingrepen
• Aanbevolen alternatief:
  • Slug-generatie via lifecycle hooks (Strapi 5-native)
  • Of een eigen lichte backend-oplossing