Setup Guide

Prerequisites

1. Clone Repository

git clone https://github.com/the-dev-center/antora-themes-site.git
cd antora-themes-site
pnpm install

2. Set Up Turso

Install CLI

Windows (requires WSL)
wsl
curl -sSfL https://get.tur.so/install.sh | bash
macOS / Linux
curl -sSfL https://get.tur.so/install.sh | bash

Create Database

turso auth login
turso db create antora-themes
turso db show antora-themes --url      # Save this
turso db tokens create antora-themes   # Save this

Configure Environment

Create .env:

TURSO_DATABASE_URL=libsql://antora-themes-yourname.aws-us-east-1.turso.io
TURSO_AUTH_TOKEN=eyJ...

Push Schema

npx drizzle-kit push

3. Configure OAuth

See Environment Variables for all OAuth provider setup.

At minimum, configure one provider for user login.

4. Local Development

pnpm dev

Site available at http://localhost:4321

5. Deploy to Vercel

Via Dashboard

  1. Push code to GitHub

  2. Go to https://vercel.com/new

  3. Import repository

  4. Add environment variables (from .env)

  5. Deploy

Via CLI

npm i -g vercel
vercel login
vercel --prod

6. Post-Deployment

  1. Update OAuth callback URLs to use your Vercel domain

  2. Test login with each configured provider

  3. Submit a test theme

Troubleshooting

Windows Build Errors

Symlink errors during local build are Windows-specific and won’t affect Vercel deployment.

Database Connection Failed

Ensure URL includes the region:

# Correct
libsql://antora-themes-user.aws-us-east-1.turso.io

# Wrong
libsql://antora-themes-user.turso.io

OAuth Callback Mismatch

Callback URLs must exactly match:

  • /api/auth/callback/github

  • /api/auth/callback/gitlab

  • /api/auth/callback/google