/nextjs-r2-demo

Upload images to Cloudflare R2 via the Workers API, Pre-signed URL, or Temporary Credentials

Primary LanguageTypeScript

Upload data to R2

A Next.js example application demonstrating image uploading to Cloudflare R2.

This is a Next.js project bootstrapped with c3.

Upload Methods

This app uses three different methods to upload and download images to an R2 bucket.

  1. Workers API: To use this method, make sure to add the R2 binding in wrangler.toml.
  2. Presigned URL: To use this method, you need Account ID, Access Key ID, and Secret Access Key. Follow the steps mentioned in the documentation to generate the required credentials.
  3. Presigned URL using Temporary Credentials: To use this method, you need Account ID, Access Key ID, and Secret Access Key. You also need a personal API Token. Check the Generating API Token section to learn more.

Getting Started

Clone the repository

Clone the repo on your local machine running the following command:

git clone https://github.com/harshil1712/nextjs-r2-demo.git

Install dependencies

Run the following command to install the required dependencies:

npm run install

Access R2

If you don't have access to R2, purchase it from your Cloudflare Dashboard.

Create a new bucket. Follow the documentation to learn how to create a new bucket.

For Workers API

Add bindings

Add the R2 bindings to the wrangler.toml file. It should look something like this:

[[r2_buckets]]
binding = "IMAGES"
bucket_name = "my-bucket"

If you update the value of binding, make sure you update it in the env.d.ts, app/api/workers-api/upload and app/api/workers-api/download files.

For Presigned URL

To use Presigned URL, you need the Account ID, Access Key ID, and Secret Access Key. Follow the steps mentioned in the documentation to generate the required credentials.

Configure credentials

Rename .env.copy to .env.local. Paste the credentials you got in the previous step.

For this method, you don't need AUTH_TOKEN. You leave it as is or remove it from the .env.local file.

Configure CORS

You will need to configure the CORS policies to be able to access the objects. Use the CORS policy available in the cors.json file.

Note: You might have to update AllowedOrigins.

You add this CORS policy to your bucket via the Dashboard. You can find the steps to do that in the documentation.

For Presigned URL with Temporary Credentials

Configure credentials

Apart from the Account ID, Access Key ID, and Secret Access Key, you also need an API Token. To create the API Token, follow the instructions mentioned in the Create API Token documentation.

Make sure you have the following permissions:

Account - Workers R2 Storage:Edit
All users - API Tokens:Edit

Rename .env.copy to .env.local. Paste the credentials you got in the previous step. For AUTH_TOKEN paste the new generated API Token.

Configure CORS

You will need to configure the CORS policies to be able to access the objects. Use the CORS policy available in the cors.json file.

Note: You might have to update AllowedOrigins.

You add this CORS policy to your bucket via the Dashboard. You can find the steps to do that in the documentation.

Run development server

Execute the following command to run the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result.

Cloudflare integration

Besides the dev script mentioned above c3 has added a few extra scripts that allow you to integrate the application with the Cloudflare Pages environment, these are:

  • pages:build to build the application for Pages using the @cloudflare/next-on-pages CLI
  • preview to locally preview your Pages application using the Wrangler CLI
  • deploy to deploy your Pages application using the Wrangler CLI

Note: while the dev script is optimal for local development you should preview your Pages application as well (periodically or before deployments) in order to make sure that it can properly work in the Pages environment (for more details see the @cloudflare/next-on-pages recommended workflow)

Bindings

Cloudflare Bindings are what allows you to interact with resources available in the Cloudflare Platform.

You can use bindings during development, when previewing locally your application and of course in the deployed application:

  • To use bindings in dev mode you need to define them in the next.config.js file under setupDevBindings, this mode uses the next-dev @cloudflare/next-on-pages submodule. For more details see its documentation.

  • To use bindings in the preview mode you need to add them to the pages:preview script accordingly to the wrangler pages dev command. For more details see its documentation or the Pages Bindings documentation.

  • To use bindings in the deployed application you will need to configure them in the Cloudflare dashboard. For more details see the Pages Bindings documentation.