ZIP-Builder für Deployments
Ein ZIP zu packen ist nicht das Problem. Dass die Plattform es danach ablehnt, schon. Dieses Werkzeug filtert den Systemmüll heraus, prüft die Verzeichniswurzel und warnt vor Limits, bevor Sie hochladen - vollständig im Browser.
Das eigentliche Problem sind drei kleine, nicht ein großes
Wer eine statische Seite von Hand hochlädt statt über ein Repository, kennt die Reihenfolge: packen, hochladen, Fehlermeldung, raten. Fast immer ist es eines von dreien.
Systemmüll im Archiv. Der macOS-Finder legt __MACOSX/ und .DS_Store mit ins ZIP. Sichtbar wird das nie, abgelehnt oder falsch ausgeliefert wird es trotzdem.
Eine Ebene zu tief. Man packt den Ordner statt seinen Inhalt - und index.html liegt danach unter dist/index.html statt an der Wurzel. Der Upload gelingt, die Seite ist leer, und die Ursache steht nirgends.
Limits, die erst beim Hochladen auffallen. Maximale Dateigröße und Dateianzahl erfährt man in dem Moment, in dem der Upload abbricht - nach der Wartezeit, nicht davor.
Der Wert liegt in der Prüfung, nicht im Packen
Komprimieren kann jedes Betriebssystem. Was es nicht kann:
- Systemmüll filtern -
__MACOSX/,.DS_Store,Thumbs.db,.git/,node_modules/ - Wurzel prüfen - „Ihre
index.htmlliegt indist/. Diese Ebene entfernen?" - Limits vorher melden - Dateigröße und Dateianzahl gegen das Ziel gehalten, bevor etwas übertragen wird
- Ordner umbauen - Dateien per Drag-and-drop in Unterverzeichnisse verschieben, ohne im Dateimanager umzuräumen
- Konfiguration gegenlesen -
_headersund_redirectsauf Syntaxfehler prüfen, solange sie noch änderbar sind
Zielplattformen
Die Prüfungen unterscheiden sich je Ziel, deshalb gibt es Voreinstellungen statt einer Einheitsprüfung:
| Ziel | Was besonders geprüft wird |
|---|---|
| Cloudflare Pages und Workers | Wurzelebene, Dateigröße, Dateianzahl, _headers und _redirects |
| Chrome Web Store, Firefox Add-ons | manifest.json muss an der Wurzel liegen - der häufigste Anfängerfehler überhaupt |
| WordPress: Plugin und Theme | Verzeichnisname und Header-Kommentar der Hauptdatei |
| Shopify-Themes, Moodle-Pakete | erwartete Verzeichnisstruktur |
Warum im Browser
Ein Deployment-Archiv ist der vollständige Quellstand einer Seite, oft vor der Veröffentlichung. Das lädt man nicht zu einem Fremdanbieter hoch, nur um Systemdateien loszuwerden. Hier verlässt keine Datei den Browser - es gibt keinen Server, an den sie gehen könnte.
Läuft vollständig in Ihrem Browser
Das Werkzeug selbst lädt nichts nach und sendet nichts. Ihre Daten werden im Browser verarbeitet und verlassen das Gerät nicht - nachprüfbar im Netzwerk-Tab der Entwicklerwerkzeuge.