Netlify Frontend
Deploy the OpenSync frontend to Netlify or Vercel.
Netlify Deploy
One-Click
Manual Deploy
Connect Repository
In Netlify, click New site from Git and connect your GitHub repository.
Configure Build
Set build settings: - Build command: npm run build - Publish
directory: dist
Set Environment Variables
Add required environment variables (see below).
Vercel Deploy
One-Click
Manual Deploy
Import Project
In Vercel, click New Project and import your repository.
Configure
Framework preset will be detected automatically (Vite).
Environment Variables
Add required environment variables.
Environment Variables
Set these in your hosting platform:
# Convex (required)
VITE_CONVEX_URL=https://your-deployment.convex.cloud
# WorkOS (required for auth)
WORKOS_API_KEY=sk_...
WORKOS_CLIENT_ID=client_...
WORKOS_COOKIE_PASSWORD=your-32-char-password
Remember to add your production URL to WorkOS CORS settings.
Build Settings
| Setting | Value |
|---|
| Build command | npm run build |
| Output directory | dist |
| Node version | 18+ |
Custom Domain
Both Netlify and Vercel support custom domains:
- Add your domain in the hosting dashboard
- Update DNS records as instructed
- Enable HTTPS (automatic)
- Update WorkOS redirect URIs
Preview Deployments
Both platforms support preview deployments for pull requests. Ensure preview URLs are added to WorkOS if you need auth to work in previews.
