Çfarë opsionesh të shpërndarjes dhe rezultatesh ndërtimi suporton Next.js?

Question

Accepted Answer

Next.js suporton disa objektiva shpërndarjesh, kontrolluar pjesërisht nga konfigurimi **`output`**. Zgjedhja e duhur varet nga fakti nëse keni nevojë për serverin Node, kontejnerë ose hosting plotësisht statik.

## Mënyrat e rezultatit të ndërtimit

```js
// next.config.js
module.exports = {
  // output: undefined  → default: needs a Node.js server (full features)
  // output: "standalone" → self-contained folder for Docker/containers
  // output: "export"     → pure static HTML/CSS/JS (no server)
};
```

## 1. Parazgjedhje (serveri Node) — veçori të plota

Zhvillon një server Node.js, kështu që merrni **të gjitha**: SSR, ISR, Server Actions, Route Handlers, optimizim të figurave, middleware. Kjo është ajo që përdorin platforme si **Vercel** (bërësi i Next.js, pa konfiguracion) dhe hostërat Node.

## 2. output: "standalone" — për Docker / self-hosting

```dockerfile
# Next traces only the needed files into .next/standalone → a tiny, self-contained server
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]
```

`standalone` prodhon një dosje minimale me vetëm varësitë që përdoren në të vërtetë, ideale për imazhe të vogla Docker në AWS, GCP, serverët tuaj, etj. Ju mbani të gjitha veçoritë e serverit.

## 3. output: "export" — plotësisht statik

```text
next build → out/  (plain HTML/CSS/JS, deployable to any static host: S3, GitHub Pages, Netlify CDN)
```

Eksporti statik jep hosting më të lirë, më të thjeshtë, por **çaktivon veçoritë e serverit**: pa SSR, pa ISR, pa Route Handlers, pa Server Actions, pa optimizim të figurave në kohë reale. Vetëm për sajtet plotësisht statike.

## Zgjedhja

```text
Need SSR/ISR/Server Actions, want zero-config → Vercel (or a Node host) — default output
Want containers / self-host with full features → output: "standalone" + Docker
Purely static content (docs, marketing)        → output: "export" → any static CDN
```

## Konsiderata të tjera

```text
- Runtime choice (Edge vs Node) affects where functions run
- Self-hosting ISR/caching needs persistent storage or a shared cache
- Image optimization on non-Vercel hosts may need a custom loader
```

## Pse është e rëndësishme

Shpërndarja nuk është e njëjtë për të gjithë: mënyra e `output` përcakton cilat veçori Next.js mbeten.

Dije që dalja **parazgjedhje/Node** mbuan të gjitha aftësitë e serverit, **standalone** i paketron ato për Docker/self-hosting, dhe **export** zëvendëson të gjitha veçoritë e serverit për hosting plotësisht statik ju lejon të përputhni ndërtimin me infrastrukturën tuaj — dhe të shmangni grackat e `output: "export"` në heshtje thyerja e SSR/ISR/Server Actions.