Waɗa keɓi cuci gida da fitowar gida Next.js ke goɗi?

Question

Accepted Answer

Next.js ke goɗi fitowan cuci gida da yawa, waɗanda aka sarrafa su kala-kala ta hanyar cumqal **`output`**. Zaɓi daidai ya danganta da ko auna ka bukaci gareshi Node, juju, ko jujun gida na cikakke.

## Hanyoyin fitowar gida

```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. Ajiya (jiji Node) — kayatawa duka

Yana gudanar da jiji Node.js, don haka ka sami **duka**: SSR, ISR, Server Actions, Route Handlers, inganta hoton, middleware. Wannan shine abin da dandali kamar **Vercel** (masu kirkira Next.js, ba a cumqala ba) da waɗanda suke bukacar Node suke amfani.

## 2. output: "standalone" — don Docker / gadamarwa

```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` yana samar da folda mara kula tare da alaƙa da aka yi amfani da su kawai, dace don siffan Docker kansan akan AWS, GCP, sabuwar gareshi, da dai sauransu. Kana tiyar da dukan kayatawan jiji.

## 3. output: "export" — cikakke shafi

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

Fitowar shafi tana ba da gajerun, mafi saukin jujun gida amma **kiyaye kayatawan jiji**: ba SSR, ba ISR, ba Route Handlers, ba Server Actions, ba inganta hoton jiya-jiya. Yana da amfani ne kawai don shafukan cikakke.

## Zaɓi

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

## Sauran bayyani

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

## Me yake mahimmaci

Jujun gida ba siga ɗaya ba: nau'in `output` yana tabbatar da waɗannan kayatawan Next.js ke cikin.

Sanin cewa fitowar **ajiya/Node** tana ajiye duka iko jiji, **standalone** ke jajaffre wa Docker/gadamarwa, da **export** ke yin jaje duka kayatawan jiji ga shafi cikakke na gida zai ba ka iko daidaita gida ga kayawar ku — da guje tsohon magudantar `output: "export"` a kuɗi kame-kame ta karye SSR/ISR/Server Actions.