Deployment Overview

Clarity can be deployed to multiple platforms. Choose the one that best fits your needs.

Deployment Options

GitHub Pages (Free)

Best for: Open source projects, personal documentation

✅ Free hosting
✅ Automatic deployment with GitHub Actions
✅ Custom domains supported
✅ Built-in SSL certificates

Limitations:

• Public repositories only (unless you have GitHub Pro)
• Builds can be slower
• Limited to static sites

Deploy to GitHub Pages →

Vercel (Recommended)

Best for: Professional projects, teams, production sites

✅ Instant deployments (seconds)
✅ Automatic preview URLs for PRs
✅ Built-in analytics and monitoring
✅ Edge network (fast worldwide)
✅ Free for personal projects

Limitations:

• Paid plans needed for teams
• Build minutes limited on free plan

Deploy to Vercel →

Netlify

Best for: JAMstack projects, continuous deployment

✅ Instant deployments
✅ Branch previews
✅ Built-in forms and functions
✅ Free SSL
✅ Free for personal projects

Limitations:

• Build minutes limited on free plan
• Bandwidth limits on free tier

[Deploy to Netlify →]

Render

Best for: Node.js apps, SSR, full-stack applications

✅ Native Node.js support
✅ Free tier available
✅ PostgreSQL included
✅ Auto-deploy from Git

Requirements:

• GitHub repository
• render.yaml configuration
• Environment variables

Deploy to Render →

Quick Comparison

Prerequisites

Before deploying to any platform, ensure you have:

1. Clarity configured locally and working
2. Git repository with your changes committed
3. Environment variables configured (see each platform guide)
4. Build tested locally with pnpm build

Next Steps

Choose your deployment platform:

• GitHub Pages Guide - Free and simple
• Vercel Guide - Fast and feature-rich
• Netlify Guide - JAMstack optimized
• Render Guide - Node.js and SSR support

Need help deciding? Start with Vercel for the best developer experience, or GitHub Pages if you want completely free hosting. For SSR and backend features, use Render.