typo3-vite

Installation
SKILL.md

TYPO3 Vite Skill

Vite 7 build configuration for TYPO3 v13 and v14 LTS sitepackage development with praetorius/vite-asset-collector. Current gold standard: v14.3 LTS (released 2026-04-21).

v14 context: TYPO3 v14.0 removed the core's built-in frontend CSS/JS concatenation and compression (Breaking #108055) and CSS comment/whitespace stripping (Breaking #107944). config.concatenateCss/compressCss/concatenateJs/compressJs no longer have any effect. An external build tool (Vite / webpack / esbuild) is required for production-grade asset handling on v14.

Key Concepts

Entrypoint-per-CE Pattern

Each content element gets its own Vite entrypoint (*.entry.ts) that imports its SCSS and TypeScript. This enables automatic code splitting -- only the CSS/JS needed for visible content elements is loaded.

Selective Bootstrap Imports

Never import Bootstrap as a whole. Import only the components you use (bootstrap/scss/grid, bootstrap/scss/buttons, etc.) to minimize CSS bundle size.

SVG Optimization

Custom SvgCopyOptimizePlugin processes SVGs from Resources/Private/Svg/ through SVGO and writes optimized files to Resources/Public/Svg/. Supports dev-mode file watching.

CSP Compliance

Assets loaded via <vite:asset> ViewHelper automatically get nonce attributes for Content Security Policy compliance. No inline <script> or <style> tags needed.

Technology Stack

Layer Technology
Build Vite 7+ with praetorius/vite-asset-collector
CSS Bootstrap 5.3+ (selective imports, custom theming)
PostCSS autoprefixer + cssnano (production)
SCSS Modern Compiler API (api: 'modern-compiler')
SVG Custom SVGO plugin (SvgCopyOptimizePlugin)
Compression Gzip + Brotli (production)
Package Manager npm, pnpm, or yarn

References

  • references/vite-configuration.md -- Complete vite.config.ts, entrypoints, SVG plugin, CSP
  • references/scss-architecture.md -- SCSS folder structure, import chain, naming conventions, CSS units
  • references/bootstrap-theming.md -- Bootstrap variable customization per project
Weekly Installs
4
First Seen
1 day ago