Deno builder for Vercel - run Deno on
vercel
. 🦕 + λ = ❤️
This builder allows you to run Deno as a lambda on vercel
.
If you're unfamiliar with vercel
runtimes, please read the runtime docs first. This runtime can be used like any other Community Runtime.
// vercel.json
{
"functions": {
"api/**/*.{j,t}s": {
"runtime": "[email protected]"
}
}
}
Note: You need vercel
v17.x or above to use the above configuration.
// api/hello.ts
import {
APIGatewayProxyEvent,
APIGatewayProxyResult,
Context,
} from 'https://deno.land/x/lambda/mod.ts';
export async function handler(
event: APIGatewayProxyEvent,
context: Context
): Promise<APIGatewayProxyResult> {
return {
statusCode: 200,
body: `Welcome to deno ${Deno.version.deno} 🦕`,
headers: {
'content-type': 'text/html; charset=utf-8',
},
};
}
That's the simplest way to use this runtime!
To use a specific version of Deno you can specify a environment variable in your vercel.json
:
// vercel.json
{
"functions": {
...
},
"env": {
"DENO_VERSION": "0.42.0"
}
}
To use Deno's unstable
mode you can specify the environment variable DENO_UNSTABLE
in your vercel.json
:
// vercel.json
{
"functions": {
...
},
"env": {
"DENO_UNSTABLE": "true"
}
}
To pass a custom config, you can specify the variable DENO_CONFIG
in your now.json
:
// now.json
{
"functions": {
...
},
"env": {
"DENO_CONFIG": "tsconfig.json"
}
}
You can place a build.sh
function in the root of your deploy directory. This will be executed before the function is packaged up.
vercel dev
is currently only supported on macOS and Linux. It is not supported on Windows.
If you have have deno
installed in your path then you can use vercel dev
with this runtime. It should work just like any other runtime.
This was only possible due to the great work of Andy Hayden who made the first attempts at running deno in a lambda function.