Developer Setup Guide

Deploy Your Own Instance

Get your own Projects Explorer up and running in under 10 minutes. Follow these steps to deploy with Vercel and Neon.

One-Click Deploy

The fastest way to get started — deploys to Vercel instantly

Create Neon Database

Set up your PostgreSQL database (free tier available)

Go to console.neon.tech and create an account
Create a new project (any name works)
Click Connection Details in the sidebar
Copy the Connection string (starts with postgresql://)

Example connection string

postgresql://user:password@ep-xxx.region.aws.neon.tech/dbname?sslmode=require

💡Use the Pooled connection option for production deployments to handle more concurrent connections.

Run Database Setup

Create tables with a single SQL script

In the Neon console, go to SQL Editor and run the setup script:

scripts/setup.sqlView on GitHub

-- Run this in your Neon SQL Editor
-- Copy from: scripts/setup.sql

-- This creates all required tables:
-- • files, projects, folders, categories
-- • sessions, download_logs, auth_logs
-- • All indexes and triggers

Alternative: Run via command line:

psql $DATABASE_URL -f scripts/setup.sql

Set Up Vercel Blob Storage

For storing uploaded files (free tier: 5GB)

Go to your Vercel Dashboard
Select your project (or create one first via deploy)
Navigate to the Storage tab
Click Create Database → Select Blob
Copy the BLOB_READ_WRITE_TOKEN from environment variables

Choose Admin Password

Secure password for dashboard access

Create a strong password for your admin dashboard. This is what you'll use to login at /login.

Generate a secure password (macOS/Linux)

openssl rand -base64 32

Use at least 12 characters with a mix of uppercase, lowercase, numbers, and symbols.

Configure Environment Variables

Add these to Vercel or your .env.local file

Variable	Description
`DATABASE_URL`	Neon PostgreSQL connection string
`ADMIN_PASSWORD`	Your chosen admin password
`BLOB_READ_WRITE_TOKEN`	Vercel Blob storage token

.env.local example

DATABASE_URL="postgresql://..."
ADMIN_PASSWORD="your-secure-password"
BLOB_READ_WRITE_TOKEN="vercel_blob_rw_..."

Deploy & Test

You're ready to go!

Vercel Deploy

Push to main branch or use one-click deploy

Local Development

Run locally with Bun or npm

bun install && bun dev

Post-Deploy Checklist

Database tables created with setup.sql
Login works at /login with your ADMIN_PASSWORD
File upload works in dashboard
Public sharing links work for downloads

Need help? Check out the documentation or open an issue.