This commit is contained in:
ISA
2025-05-27 13:26:47 +02:00
parent cdca624874
commit 69d28844a2
9 changed files with 156 additions and 5 deletions

46
docs/build-and-deploy.md Normal file
View File

@@ -0,0 +1,46 @@
<!-- /docs/build-amddeploy.md -->
# 🛠 Deployment & Build-Verhalten (Next.js)
Diese Datei beschreibt, welche Projektdateien in den Build (`.next/`) aufgenommen werden und welche nicht.
Ziel: Klarheit für Onboarding, Deployment-ZIP-Erstellung oder CI/CD.
---
## 📦 Wird beim `npm run build` in `.next/` gespeichert
| Inhalt | Beschreibung |
| ---------------------- | -------------------------------------------------- |
| Kompilierte Seiten | Alle unter `/pages/` |
| API-Routen | Alles aus `pages/api/` |
| Assets aus `public/` | Werden im Build nicht verändert, aber ausgeliefert |
| CSS-Dateien (Tailwind) | Werden gebundelt und minimiert |
| `.env.local` | Wird eingelesen, aber nicht exportiert |
| JS/TS-Quellcode | Wird zu Client- und Server-Bundles kompiliert |
---
## 🧹 Wird **nicht** in `.next/` aufgenommen
| Ordner/Datei | Zweck / Grund |
| --------------------------- | -------------------------------------------- |
| `__tests__`, `__mocks__` | Nur lokal für Tests, nicht im Build |
| `cypress/` | End-to-End-Tests, nur für lokale Entwicklung |
| `scripts/` | Hilfsskripte, nicht für Runtime relevant |
| `docs/` | Dokumentation, nur für Entwickler |
| `README.md`, `CHANGELOG.md` | Doku nicht erforderlich zur Laufzeit |
| `Jenkinsfile`, `.github/` | CI/CD wird vom Buildsystem verwendet |
---
## 📂 Empfohlene Struktur für Deployment (z.B. ZIP-Upload auf Server)
Nur folgende Dateien/Ordner übertragen:
```bash
.next/
public/
package.json
package-lock.json
.env.local
```