Examples
EN

Vercel

Deploy your Hwaro site to Vercel with zero-config deployments.

Quick Start

Generate Config

hwaro tool platform vercel

This creates a vercel.json with build settings, redirects from aliases, and (when fingerprinted asset bundles are enabled) cache headers.

Deploy via Git

  1. Push your repository to GitHub, GitLab, or Bitbucket
  2. Go to Vercel and click Add New > Project
  3. Import your repository
  4. Vercel will auto-detect vercel.json settings
  5. Click Deploy

Manual Configuration

If you prefer to configure manually, create vercel.json:

{
  "buildCommand": "hwaro build",
  "outputDirectory": "public"
}

Redirects

Page aliases defined in frontmatter are automatically included as 301 redirects when using hwaro tool platform vercel:

---
title: New Post
aliases:
  - /old-url/
---

Generates:

{
  "redirects": [
    {
      "source": "/old-url/",
      "destination": "/posts/new-post/",
      "statusCode": 301
    }
  ]
}

Custom Domain

  1. Go to Settings > Domains
  2. Add your custom domain
  3. Follow DNS configuration instructions
  4. Update base_url in config.toml:
base_url = "https://www.yourdomain.com"

Preview Deployments

Vercel automatically creates preview deployments for every push to non-production branches. No additional configuration is needed.

See Also