Upload to Vercel Blob

This GitHub Action allows you to upload files or entire folders to Vercel Blob storage by specifying a source path and destination path. It provides an easy way to manage blob storage in your Vercel projects through GitHub Actions workflows.

Inputs

source

Required The source path of the file or folder you want to upload to Vercel Blob storage.

• File: Upload a single file
• Folder: Upload all files within the folder (including subdirectories)

destination

Required The destination path where the file(s) should be stored in Vercel Blob storage.

• For files: The exact destination path for the file
• For folders: The base path where all files will be uploaded (maintaining folder structure)

read-write-token

Required Your Vercel Blob read-write token (BLOB_READ_WRITE_TOKEN). This should be stored as a GitHub secret for security.

Outputs

This action does not provide any outputs for privacy and security reasons. To access your uploaded files, check your Vercel dashboard under Storage → Blob.

Environment Variables

This action requires a Vercel Blob read-write token. The action will automatically set the BLOB_READ_WRITE_TOKEN environment variable for the Vercel Blob SDK to use. You can obtain this token from your Vercel dashboard:

1. Go to your Vercel dashboard
2. Navigate to Storage → Blob
3. Create or copy your BLOB_READ_WRITE_TOKEN
4. Add it as a GitHub secret in your repository

Usage

Single File Upload

Upload a single file to Vercel Blob storage:

name: Upload Single File

on:
  push:
    branches: [main]

jobs:
  upload-file:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Upload file to Vercel Blob
        uses: dartilesm/vercel-blob-action@v2
        with:
          source: "path/to/file.txt"
          destination: "uploads/file.txt"
          read-write-token: ${{ secrets.BLOB_READ_WRITE_TOKEN }}

Folder Upload

Upload an entire folder (including subdirectories) to Vercel Blob storage:

name: Upload Build Folder

on:
  push:
    branches: [main]

jobs:
  build-and-upload:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Build project
        run: |
          # Your build commands here
          mkdir -p dist/assets
          echo "Main file" > dist/index.html
          echo "Stylesheet" > dist/assets/style.css
          echo "Script" > dist/assets/script.js

      - name: Upload entire build folder to Vercel Blob
        uses: dartilesm/vercel-blob-action@v2
        with:
          source: "dist/"
          destination: "builds/${{ github.sha }}"
          read-write-token: ${{ secrets.BLOB_READ_WRITE_TOKEN }}