Netlify Deploy

Über

Das Plugin zeigt an den Dokumenten der angegebenen Collections einen Publish-Button neben Speichern an. Optional lässt er sich auch in die Admin-Kopfzeile einbauen, was für Single-Site-Setups praktisch ist. Ein Klick startet einen Netlify-Build der Site, auf die das Dokument aufgelöst wird. Der Button zeigt den aktuellen Status der Site: live, nicht veröffentlicht, in Warteschlange, wird gebaut, Vorschau bereit, Build fehlgeschlagen oder wird veröffentlicht. Über die Option changes sieht man, welche Dokumente seit dem letzten Live-Build gespeichert wurden. Das Build-Log wird während des Builds über eine WebSocket-Verbindung in eine Drawer-Ansicht gestreamt. Schlägt ein Build fehl, zeigt das Plugin den Fehlergrund von Netlify an. Pro Site läuft immer nur ein Build gleichzeitig. Solange ein Build läuft, ist der Button gesperrt, auch wenn der Build durch einen Git-Push oder einen Build-Hook ausgelöst wurde. Ist das automatische Veröffentlichen in Netlify deaktiviert, erzeugt der Build zunächst eine Vorschau. Diese lässt sich über den Netlify-URL öffnen, veröffentlichen, neu bauen oder abbrechen. Die Option site akzeptiert eine feste Netlify-Site-ID oder Domain. Alternativ kann eine Funktion übergeben werden, die das aktuelle Dokument erhält und eine Site zurückgibt, optional mit einem Hinweistext. So kann eine CMS-Instanz mehrere Sites steuern. Zugriffsrechte für Build und Veröffentlichung werden über die üblichen Payload-Access-Funktionen geregelt. Die serverseitigen Hooks onBuild und onPublish laufen, nachdem ein Build gestartet oder eine Vorschau veröffentlicht wurde, etwa um eine Slack-Nachricht zu senden. Voraussetzungen sind Payload 3.84 oder neuer, React 19, Node 22 oder neuer sowie ein persönliches Netlify-Access-Token in der Umgebungsvariable NETLIFY_AUTH_TOKEN auf dem Server. Das Plugin funktioniert nur mit Sites, die auf Netlify gebaut werden. Sites, die von einer externen CI hochgeladen werden, haben keinen Netlify-Build, den das Plugin starten könnte.

Paketinformationen

Paketname

@focus-reactive/payload-plugin-netlify-deploy

Neueste Version

1.1.0

Entpackte Größe

185 kB

Lizenz

MIT

Wöchentliche Downloads

48

Zuletzt veröffentlicht

29. Sep. 2026