Netlify

Deploy your Velocity site to Netlify.

Quick Deploy

1. Push your code to GitHub, GitLab, or Bitbucket

2. Log in to Netlify

3. Click “New site from Git”

4. Select your repository

5. Set environment variables

6. Click Deploy

CLI Deployment

# Install Netlify CLI
pnpm add -g netlify-cli

# Login
netlify login

# Deploy preview
netlify deploy

# Deploy to production
netlify deploy --prod

Configuration

Create netlify.toml in project root:

[build]
  command = "pnpm build"
  publish = "dist"

[build.environment]
  NODE_VERSION = "22"

Server-Side Features

For API routes and SSR, add the Netlify adapter:

pnpm add @astrojs/netlify

astro.config.mjs

import netlify from '@astrojs/netlify';

export default defineConfig({
  output: 'server',
  adapter: netlify(),
});

Environment Variables

Set in Netlify Dashboard → Site Settings → Environment Variables:

SITE_URL=https://your-site.netlify.app
PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX

Or in netlify.toml:

[context.production.environment]
  SITE_URL = "https://yoursite.com"

Custom Domain

1. Go to Domain Settings
2. Add custom domain
3. Configure DNS
4. Enable HTTPS

Functions

Netlify Functions for serverless:

netlify/functions/hello.ts

export async function handler(event, context) {
  return {
    statusCode: 200,
    body: JSON.stringify({ message: 'Hello!' }),
  };
}

Build Settings

Setting	Value
Build Command	pnpm build
Publish Directory	dist
Node Version	22

Deploy Previews

Every pull request gets a preview URL:

• deploy-preview-123--your-site.netlify.app

Troubleshooting

Build Timeout

Increase timeout in netlify.toml:

[build]
  command = "pnpm build"
  publish = "dist"

[functions]
  timeout = 60

Node Version

Ensure Node 22+ in netlify.toml:

[build.environment]
  NODE_VERSION = "22"