README

UI Profiler

Symfony Web Profiler toolbar and panels rebuilt with UI Kernel and UX Blocks

Warning

Dev/test only. Flex registers this bundle for dev and test — do not enable in production.

Note

Read-only mirror. See CONTRIBUTING.md for how to propose changes.

Features

• UI Kernel chrome — theme tokens for toolbar and WDT shell
• ux-blocks markup — core Twig components for profiler panels
• Stock collectors — Symfony Web Profiler data with refreshed layout
• Owned Sass pipeline — shell/WDT CSS authored in assets/scss/, compiled to assets/styles/
• Dev-only — Flex recipe registers bundle for dev and test

Prerequisites

Add the symfinity/recipes Flex endpoint to your project's composer.json (see recipes README) — recipes are not in Symfony's official recipe repository yet.

Installation

Install with --dev. Requires themed ux-blocks stack.

composer require symfinity/ui-profiler --dev

Quick Start

composer require symfinity/ui-profiler --dev

See Quick start for the full walkthrough.

Documentation

• Quick start — minimal setup path
• Third-party collectors — custom profiler panels
• Upstream sync — Symfony Web Profiler alignment

Maintainer CSS (Sass pipeline)

Author shell and WDT rules in SCSS; commit compiled CSS (same pattern as symfinity/ux-blocks-core):

cd packages/ui-profiler
bin/profiler-css-compile          # compile (requires Node/npx + dart-sass)
bin/profiler-css-compile --check  # CI freshness gate
composer scss:check               # same as --check

Runtime: ProfilerCssProvider reads committed CSS for inline <style> tags (WDT + shell). ux-blocks-core role CSS remains separate.

Author layout:

assets/scss/
  shared/          — tokens + mixins (compile-time)
  shell/           — shell partials (@use from shell-chrome.scss)
  wdt/             — toolbar + critical partials
  shell-chrome.scss
  wdt-toolbar.scss
  wdt-critical.scss

JavaScript layout

Shell, WDT, and panel scripts are served by ProfilerAssetController at /_profiler/assets/{path} (not Stimulus — do not merge into controllers/).

Requirements

• PHP 8.2 or higher
• Symfony 7.4 or 8.x
• symfinity/ui-kernel, symfinity/ux-blocks-core
• symfony/web-profiler-bundle

Support

• GitHub Issues
• Security
• Contributing

License

MIT