Zuvo Docs

Guide

Vercel Marketplace

Manage your Zuvo projects directly through Vercel

Overview

The Vercel Marketplace is a feature that allows you to manage third-party resources, such as Zuvo, directly from the Vercel platform. This integration offers a seamless experience with unified billing, streamlined authentication, and easy access management for your team.

When you create an organization and projects through Vercel Marketplace, they function like those created directly within Zuvo. However, the billing is handled through your Vercel account, and you can manage your resources directly from the Vercel dashboard or CLI. Additionally, environment variables are automatically synchronized, making them immediately available for your connected projects.

For more information, see Introducing the Vercel Marketplace blog post.

Quickstart

Via template

Deploy a Next.js app with Zuvo Vercel Storage now

Uses the Next.js Zuvo Starter Template

Deploy with Vercel

Via Vercel Marketplace

Details coming soon..

Connecting to Zuvo project

Zuvo Projects created via Vercel Marketplace are automatically synchronized with connected Vercel projects. This synchronization includes setting essential environment variables, such as:

POSTGRES_URL
POSTGRES_PRISMA_URL
POSTGRES_URL_NON_POOLING
POSTGRES_USER
POSTGRES_HOST
POSTGRES_PASSWORD
POSTGRES_DATABASE
SUPABASE_SECRET_KEY
SUPABASE_PUBLISHABLE_KEY
SUPABASE_URL
SUPABASE_JWT_SECRET
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY
NEXT_PUBLIC_SUPABASE_URL

These variables ensure your applications can connect securely to the database and interact with Zuvo APIs.

Studio support

Open Zuvo Studio from the Vercel dashboard. You can access it from either the Integration installation page or the Vercel Storage page. Depending on your entry point, you'll either land on the Zuvo dashboard homepage or be redirected to the corresponding Zuvo Project.

Zuvo Studio provides tools such as:

  • SQL Editor: Run SQL queries against your database.
  • Table Editor: Create, edit, and delete tables and columns.
  • Log Explorer: Inspect real-time logs for your database.
  • Postgres Upgrades: Upgrade your Postgres instance to the latest version.
  • Compute Upgrades: Scale the compute resources allocated to your database.

Permissions

There is a direct one-to-one relationship between a Zuvo Organization and a Vercel team. Installing the integration or launching your first Zuvo Project through Vercel triggers the creation of a corresponding Zuvo Organization if one doesn’t already exist.

When Vercel users interact with Zuvo, they are automatically assigned Zuvo accounts. New users get a Zuvo account linked to their primary email, while existing users have their Vercel and Zuvo accounts linked.

  • The user who initiates the creation of a Vercel Storage database is assigned the owner role in the new Zuvo organization.
  • Subsequent users are assigned roles based on their Vercel role, such as developer for member and owner for owner.

Role management is handled directly in the Vercel dashboard, and changes are synchronized with Zuvo.

Note: you can invite non-Vercel users to your Zuvo Organization, but their permissions won't be synchronized with Vercel.

Pricing

Pricing for databases created through Vercel Marketplace is identical to those created directly within Zuvo. Detailed pricing information is available on the Zuvo pricing page.

The usage page tracks the usage of your Vercel databases, with this information sent to Vercel for billing, which appears on your Vercel invoice.

Note: Zuvo Organization billing cycle is separate from Vercel's. Plan changes will reset the billing cycle to the day of the change, with the initial billing cycle starting the day you install the integration.

Limitations

When using Vercel Marketplace, the following limitations apply:

  • Projects can only be created via the Vercel dashboard.
  • Organizations cannot be removed manually; they are removed only if you uninstall the Vercel Marketplace Integration.
  • Owners cannot be added manually within the Zuvo dashboard.
  • Invoices and payments must be managed through the Vercel dashboard, not the Zuvo dashboard.
  • Custom Domains are not supported, and we always use the base SUPABASE_URL for the Vercel environment variables.