arc-plugin-esbuild

arc-plugin-esbuild

Bundles arc functions with esbuild, includes dependencies and tree shakes!

Arc serverless framework plugin for compiling your functions with ESBuild Bundler

Install

npm i --save-dev arc-plugin-esbuild

Usage

After installing add @plugins and @esbuild pragmas to your app.arc file:

app.arc

@app
myapp

@aws
runtime esbuild

@http
get /

@plugins
arc-plugin-esbuild

Options

This plugin supports the following options under the @esbuild pragma:

Option	Description	Example
buildDirectory	The directory to write the bundled files to. This directory will be used at deploy-time before bundling your functions for deployment. Defaults to .esbuild. If you use hydration it's recommended to set this to src and commingle your js and ts.	buildDirectory .esbuild
external	esbuild package externals defaults to aws-sdk passed directly to esbuild	external '@prisma/client' aws-sdk
baseRuntime	The lambda runtime we should target. Defaults to nodejs16.x	baseRuntime nodejs14.x
configFile	A config file that is passed to esbuild. This allows for esbuild plugins. It should be a commonjs .js file as it will be required(). You can override everything so be careful. See our source for existing build options.	configFile .esbuildrc.js

Hydration

Custom runtimes do not support any shared code or hydration.

Sample Application

There is a sample application located under sample-app/. cd into that directory, npm install and you can run locally via arc sandbox or deploy to the internet via arc deploy.