Next.js کون سے deployment options اور build outputs کو سپورٹ کرتا ہے؟

Question

Accepted Answer

Next.js متعدد deployment targets کو سپورٹ کرتا ہے، جو کہ جزوی طور پر **`output`** config سے کنٹرول ہوتے ہیں۔ صحیح انتخاب اس بات پر منحصر ہے کہ آپ کو Node server، containers، یا خالص static hosting کی ضرورت ہے یا نہیں۔

## build output modes

```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. Default (Node server) — مکمل features

ایک Node.js server چلاتا ہے، اس لیے آپ کو **سب کچھ** ملتا ہے: SSR، ISR، Server Actions، Route Handlers، image optimization، middleware۔ یہ وہی ہے جو **Vercel** (Next.js کا سازندہ، zero-config) اور Node hosts استعمال کرتے ہیں۔

## 2. output: "standalone" — 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` صرف استعمال شدہ dependencies کے ساتھ ایک کم سے کم folder تیار کرتا ہے، جو AWS، GCP، آپ کے اپنے servers وغیرہ پر چھوٹی Docker images کے لیے موزوں ہے۔ آپ تمام server features برقرار رکھتے ہیں۔

## 3. output: "export" — مکمل طور پر static

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

Static export سب سے سستی، سب سے سادہ hosting فراہم کرتا ہے لیکن **server features کو غیر فعال کرتا ہے**: کوئی SSR نہیں، کوئی ISR نہیں، کوئی Route Handlers نہیں، کوئی Server Actions نہیں، کوئی آن دی فلائے image optimization نہیں۔ صرف مکمل طور پر static sites کے لیے موزوں ہے۔

## منتخب کرنا

```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
```

## دیگر تحفظات

```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
```

## یہ کیوں اہم ہے

Deployment ایک جیسی نہیں ہے: `output` mode یہ طے کرتا ہے کہ کون سی Next.js features برقرار رہتی ہیں۔

یہ جاننا کہ **default/Node** output تمام server capabilities کو برقرار رکھتا ہے، **standalone** انہیں Docker/self-hosting کے لیے پیکج کرتا ہے، اور **export** خالص static hosting کے لیے تمام server features کو تبدیل کرتا ہے آپ کو build کو اپنی infrastructure سے میل کھانے دیتا ہے — اور `output: "export"` خاموشی سے SSR/ISR/Server Actions کو توڑنے کے پھندے سے بچاتا ہے۔