Configuration Overview

Velocity uses a centralized configuration approach with TypeScript for type safety.

Configuration Files

Site Config

src/config/site.config.ts — Site metadata, branding, contact info, and social links.

Routes

src/config/routes.ts — Type-safe route definitions and navigation structure.

Environment

.env — Environment variables for different deployment contexts.

Quick Configuration

The most common configurations you’ll change:

1. Site Information

src/config/site.config.ts

const siteConfig = {
  name: 'Your Site Name',
  description: 'Your site description',
  url: import.meta.env.SITE_URL,
  author: 'Your Name',
  email: 'hello@yoursite.com',
};

2. Navigation

src/config/routes.ts

export const routes = {
  home: { path: '/', nav: { show: false, order: 0, label: 'Home' } },
  about: { path: '/about', nav: { show: true, order: 1, label: 'About' } },
  blog: { path: '/blog', nav: { show: true, order: 2, label: 'Blog' } },
  contact: { path: '/contact', nav: { show: true, order: 3, label: 'Contact' } },
};

3. Environment Variables

.env

SITE_URL=https://yoursite.com
PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX

Next Steps

• Site Configuration — Detailed site config options
• Routes — Route configuration and helpers
• Environment Variables — Environment variable reference