The Capyseo Vite plugin provides build-time SEO analysis for SvelteKit projects.
Installation
npm install -D @capyseo/adapter-sveltekit
Basic Setup
Add to vite.config.ts:
import { sveltekit } from '@sveltejs/kit/vite';
import { capyseo } from '@capyseo/adapter-sveltekit/vite';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [
sveltekit(),
capyseo(),
],
});
Configuration
capyseo({
// Enable/disable (default: true in dev, false in build)
enabled: true,
// Minimum score for build (fails if below)
minScore: 75,
// Fail build on SEO errors
failOnError: true,
// Paths to exclude
exclude: ['/admin/*', '/api/*'],
// Gemini API key for AI suggestions
geminiApiKey: process.env.GEMINI_API_KEY,
});
Options
Option
Type
Default
Description
enabled
boolean
true in dev
Toggle analysis
minScore
number
0
Min score for build
failOnError
boolean
false
Fail on SEO errors
exclude
string[]
-
Glob patterns to skip
geminiApiKey
string
env var
AI API key
Development Mode
In development, the plugin:
Intercepts HTML responses via middleware
Analyzes asynchronously (non-blocking)
Logs issues to console
Never fails dev server
npm run dev
# Console shows SEO analysis for each page
Build Mode
During npm run build:
Analyzes all pages via transformIndexHtml
Checks minimum score if minScore set
Checks for errors if failOnError: true
Fails build if criteria not met
npm run build
# Fails if score < minScore or errors exist
Examples
Minimal (Dev Only)
capyseo()
// Analyzes in dev, disabled in build
Strict Build Enforcement
capyseo({
minScore: 80,
failOnError: true,
})
// Build fails if score < 80 or errors exist
With AI Suggestions
capyseo({
geminiApiKey: process.env.GEMINI_API_KEY,
})
// AI-generated meta descriptions and alt text
