Astro Configuration

This page documents the complete Astro configuration used in the portfolio site. The configuration is defined in astro.config.mjs at the project root.

Overview

The Astro configuration sets up server-side rendering with Cloudflare, internationalization, experimental font optimization, environment variables, and integrations for code highlighting and sitemap generation.

// astro.config.mjs location
~/workspace/source/astro.config.mjs

Core Configuration

string

default:"server"

Specifies the output mode for the site. Set to "server" to enable server-side rendering (SSR).Value: "server"

function

default:"cloudflare()"

The deployment adapter for SSR. Uses @astrojs/cloudflare adapter for deploying to Cloudflare Pages/Workers.Value: cloudflare()Import: import cloudflare from '@astrojs/cloudflare'

string

required

The public URL of your deployed site. Used for generating canonical URLs and sitemaps.Value: "https://lewiskori.com"

Experimental Features

array

Experimental font optimization feature that automatically loads and optimizes web fonts.

Show Font Configuration

fontProviders.google()

Font provider service. Uses Google Fonts provider.

string

Font family name: "Inter"

string

CSS custom property for the font: "--font-inter"

array

Fallback font stack: ["sans-serif"]

string

Font display strategy: "swap" (shows fallback font while web font loads)

Environment Variables

object

Defines type-safe environment variables with validation and context specifications.

Show Environment Variable Schema

string

Beehiiv publication identifier for newsletter integration.

Context: server (server-side only)
Access: secret (treated as sensitive data)
Default: "abc"

string

API key for Beehiiv newsletter service authentication.

Context: server (server-side only)
Access: secret (treated as sensitive data)
Default: "" (empty string)

string

Google Tag Manager container ID for analytics tracking.

Context: client (client-side accessible)
Access: public (publicly visible)
Default: "" (empty string)

Internationalization (i18n)

object

Configuration for multi-language support across the site.

Show i18n Settings

string

Default language for the site: "en" (English)

array

Supported language codes: ["en", "es", "fr", "de"]

en - English
es - Spanish
fr - French
de - German

boolean

Whether to prefix default locale in URLs: falseWhen false, English URLs are /about instead of /en/about

Vite Configuration

array

Vite plugins for build tooling and development server.Plugins:

tailwindcss() - TailwindCSS Vite plugin for styling

Import: import tailwindcss from '@tailwindcss/vite'

Integrations

Expressive Code

expressiveCode

Syntax highlighting integration for code blocks with advanced features.Import: import expressiveCode from 'astro-expressive-code'

Show Configuration

array

Code block theme: ["aurora-x"]Uses the Aurora X theme for syntax highlighting.

Sitemap

sitemap

Automatic XML sitemap generation for SEO with custom priority rules.Import: import sitemap from '@astrojs/sitemap'

Show Default Configuration

string

Default change frequency: "weekly"

number

Default priority: 0.7

Date

Last modification date: new Date()

Show Custom Priority Rules

The serialize function customizes sitemap entries based on URL patterns:Homepage (/)

Change frequency: daily
Priority: 1.0

Blog Posts (/blog/[slug]/)

Change frequency: weekly
Priority: 0.8

Main Pages (/about, /contact, /projects, /advisory, /operating-notes)

Change frequency: monthly
Priority: 0.9

Blog Index (/blog/)

Change frequency: daily
Priority: 0.9

Resources (/resources/)

Change frequency: monthly
Priority: 0.6

Complete Configuration

import { defineConfig, envField, fontProviders } from 'astro/config';
import tailwindcss from '@tailwindcss/vite';
import expressiveCode from 'astro-expressive-code';
import sitemap from '@astrojs/sitemap';
import cloudflare from '@astrojs/cloudflare';

const SITE_URL = 'https://lewiskori.com';

export default defineConfig({
  output: 'server',
  adapter: cloudflare(),
  site: SITE_URL,
  experimental: {
    fonts: [
      {
        provider: fontProviders.google(),
        name: 'Inter',
        cssVariable: '--font-inter',
        fallbacks: ['sans-serif'],
        display: 'swap',
      },
    ],
  },
  env: {
    schema: {
      BEEHIIV_PUBLICATION_ID: envField.string({
        context: 'server',
        access: 'secret',
        default: 'abc',
      }),
      BEEHIIV_API_KEY: envField.string({
        context: 'server',
        access: 'secret',
        default: '',
      }),
      GTM_ID: envField.string({
        context: 'client',
        access: 'public',
        default: '',
      }),
    },
  },
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'es', 'fr', 'de'],
    routing: {
      prefixDefaultLocale: false,
    },
  },
  vite: {
    plugins: [tailwindcss()],
  },
  integrations: [
    expressiveCode({
      themes: ['aurora-x'],
    }),
    sitemap({
      changefreq: 'weekly',
      priority: 0.7,
      lastmod: new Date(),
      serialize(item) {
        // Custom priority logic...
      },
    }),
  ],
});

Site Configuration - Site metadata and personal information
Content Schema - Content collections schema definitions

Configuration

Components

API Routes

Overview

Core Configuration

Experimental Features

Environment Variables

Internationalization (i18n)

Vite Configuration

Integrations

Expressive Code

Sitemap

Complete Configuration

​Overview

​Core Configuration

​Experimental Features

​Environment Variables

​Internationalization (i18n)

​Vite Configuration

​Integrations

​Expressive Code

​Sitemap

​Complete Configuration

​Related Configuration

Overview

Core Configuration

Experimental Features

Environment Variables

Internationalization (i18n)

Vite Configuration

Integrations

Expressive Code

Sitemap

Complete Configuration

Related Configuration