Skip to content

VitePress Static Site Setup

This project uses VitePress as a static site generator only with a simplified configuration.

Quick Start

Development

bash
npm run docs:dev

Starts the development server at http://localhost:5173 (or next available port)

Build for Production

bash
npm run docs:build

Generates static files in the public/ directory for GitLab Pages

Preview Production Build

bash
npm run docs:preview

Serves the built files locally for testing

Key Features

  • Simple Configuration: Minimal Vite config focused on static generation
  • GitLab Pages Ready: Outputs to public/ directory as required by GitLab Pages
  • Vuetify Integration: Vue component library with SSR support
  • Multi-language: German (/de/) and English (/en/) locales
  • Clean Dependencies: Removed problematic packages (deck.gl, mapbox) for faster builds

File Structure

  • .vitepress/config.mjs - Main VitePress configuration
  • components/ - Vue components
  • static/ - Static assets (logos, images, etc.)
  • public/ - Generated build output (GitLab Pages deployment)

Notes

  • The build process includes console output from Supabase client initialization during SSR - this is normal
  • Large chunks warning is expected due to Vuetify and other dependencies
  • Build time: ~27 seconds

Last updated: