Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lewis-kori/astro-portfolio-v3/llms.txt

Use this file to discover all available pages before exploring further.

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

​
output
string
default:"server"
Specifies the output mode for the site. Set to "server" to enable server-side rendering (SSR).Value: "server"
​
adapter
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'
​
site
string
required
The public URL of your deployed site. Used for generating canonical URLs and sitemaps.Value: "https://lewiskori.com"

​
Experimental Features

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

​
Environment Variables

​
env.schema
object
Defines type-safe environment variables with validation and context specifications.

​
Internationalization (i18n)

​
i18n
object
Configuration for multi-language support across the site.

​
Vite Configuration

​
vite.plugins
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

​
integrations[0]
expressiveCode
Syntax highlighting integration for code blocks with advanced features.Import: import expressiveCode from 'astro-expressive-code'

​
Sitemap

​
integrations[1]
sitemap
Automatic XML sitemap generation for SEO with custom priority rules.Import: import sitemap from '@astrojs/sitemap'

​
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...
      },
    }),
  ],
});

Build docs developers (and LLMs) love

Get started for freeTalk to us