Vercel è una piattaforma cloud che ti consente di costruire, distribuire e scalare le tue app.

NOTE

`Bun.serve` non è attualmente supportato su Vercel Functions. Usa Bun con framework supportati da Vercel, come Next.js, Express, Hono o Nitro.

---

Configurare Bun in vercel.json

Per abilitare il runtime Bun per le tue Functions, aggiungi un campo bunVersion nel tuo file vercel.json:

{
	"bunVersion": "1.x"
}

Vercel rileva automaticamente questa configurazione ed esegue la tua applicazione su Bun. Il valore deve essere "1.x", Vercel gestisce internamente la versione minor.

Per ottenere i migliori risultati, allinea la versione locale di Bun con la versione usata da Vercel.

Configurazione di Next.js

Se stai distribuendo un progetto Next.js (incluso ISR), aggiorna gli script del tuo package.json per usare il runtime Bun:

{
	"scripts": {
		"dev": "bun --bun next dev", 
		"build": "bun --bun next build"
	}
}

NOTE

Il flag `--bun` esegue Next.js CLI sotto Bun. Il bundling (tramite Turbopack o Webpack) rimane invariato, ma tutti i comandi vengono eseguiti all'interno del runtime Bun.

Questo assicura che sia lo sviluppo locale che le build usino Bun.

Distribuire la tua app

Connetti il tuo repository a Vercel o distribuisci dalla CLI:

# Usando bunx (nessuna installazione globale)
bunx vercel login
bunx vercel deploy

Oppure installa la Vercel CLI globalmente:

bun i -g vercel
vercel login
vercel deploy

Scopri di più nella documentazione Vercel Deploy CLI →

Verificare il runtime

Per confermare che il tuo deploy usa Bun, registra la versione di Bun:

console.log("runtime", process.versions.bun);

runtime 1.3.3

Consulta la documentazione Vercel Bun Runtime per il supporto delle funzionalità →

---

• Fluid compute: Sia i runtime Bun che Node.js vengono eseguiti su Fluid compute e supportano le stesse funzionalità principali di Vercel Functions.
• Middleware: Per eseguire Routing Middleware con Bun, imposta il runtime su nodejs:

export const config = { runtime: "nodejs" };