Add static files to Edge Functions #32815

laktek · 2025-01-15T23:26:25Z

laktek
Jan 15, 2025
Maintainer

Supabase CLI 2.7.0 adds support for bundling Edge Functions with static files.

You can access bundled files via Deno's file-system APIs. Here's an example function that serves a PDF file.

import fs from 'node:fs'; // This should be the first import to prevent other modules to trying to use their own polyfills.


Deno.serve(async () => {
  return new Response(
    await Deno.readFile("./my-book.pdf"),
    {
      headers: {
        "Content-Type": "application/pdf",
        "Content-Disposition": 'attachment; filename="my-book.pdf"',
      },
    },
  );
});

Use cases

Use custom Wasm modules in your Edge Functions (check this guide for more details on how to write & use wasm modules in Edge Functions)
Create paywalls for serving digital content like ebooks
HTML email templates for sending emails using Edge Functions

How to configure

You will need to add static files to the function's directory to bundle them. Then, in the supabase/config.toml file for the project, add these lines:

[functions.buy-book]
static_files = [ "./functions/buy-book/my-book.pdf" ]

You can specify an array of files or use a glob pattern (eg: "./functions/email-templates/*.html")

Check the CLI configuration reference for more details: https://supabase.com/docs/guides/local-development/cli/config#functions.function_name.static_files

Note: This feature is currently not available with branching and will be added with the next stable release of the CLI.

pat-mw · 2025-02-18T21:27:48Z

pat-mw
Feb 18, 2025

Is this merged yet?
Need it so I can load email templates from html files

5 replies

laktek Feb 19, 2025
Maintainer Author

yes, it is already available in CLI versions 2.7.0 and up.

JamesHabben Apr 25, 2025

Did this break recently? trying to include files with this option on intel macos 15 with CLI 2.22.6 and it won't include any files. I can cause an error in the deploy by using a bad path glob, so I know the static_files option is at least being read for something.

baptistesx Apr 30, 2025

@JamesHabben did you manage to make it work?

Why @laktek are you talking of 2.7.0? It seems that the most recent cli version is 2.22.6, no? or I miss understand something?

Thank you :)

JamesHabben Apr 30, 2025

I did not. I have just put the contents of these files directly into the function code for now.

The versions may look off but if you left pad zeros you can see that 2.07 < 2.22

minznerjosh May 12, 2025

~~I also can't get this to work using 2.22.12.~~

Edit: I'm a fool. The static_files property was still commented out in the config. 🤦

jektvik · 2025-08-07T09:15:52Z

jektvik
Aug 7, 2025

How the heck does this work

Supabase CLI 2.7.0 adds support for bundling Edge Functions with static files

but supabase cli is 2.33 today.

Anyway the command seems to execute anyway as it says the files are being uploaded but they are nowhere to be found in the cloud interface.

So bottom line is: it doesn't work.

3 replies

laktek Aug 8, 2025
Maintainer Author

Looks like there's a bug in Studio Dashboard when listing static files. We'll resolve it soon.

However, if you do Deno.readFile('/path-to-file') within function it should work.

timohuennebeck Aug 30, 2025

I’m running into a similar problem where .txt files aren’t showing up, and I also get a "path not found" error when deployed, even though everything works fine locally. Any updates on this? It’d make it a lot easier to debug.

qtangs Sep 12, 2025

I managed to get this working by running supabase locally before deploying (supabase start). When I shut down docker, deploy still succeeds but it shows WARNING: Docker is not running and static files don't get uploaded despite the log saying files are uploaded.

Looks like there's a bug in Studio Dashboard when listing static files. We'll resolve it soon.

Not only are the static files not listed in dashboard, they're also not included in the zip file using "Download". Hope both will be fixed.

Add static files to Edge Functions #32815

Uh oh!

Uh oh!

laktek Jan 15, 2025 Maintainer

Use cases

How to configure

Replies: 2 comments · 8 replies

Uh oh!

Uh oh!

laktek Feb 19, 2025 Maintainer Author

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

laktek Aug 8, 2025 Maintainer Author

Uh oh!

Uh oh!

Uh oh!

laktek
Jan 15, 2025
Maintainer

Replies: 2 comments 8 replies

laktek Feb 19, 2025
Maintainer Author

laktek Aug 8, 2025
Maintainer Author