symfinity/ui-profiler

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

Maintainers

Package info

github.com/symfinity/ui-profiler

Language:Twig

Type:symfony-bundle

pkg:composer/symfinity/ui-profiler

Transparency log

Fund package maintenance!

serotoninja

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.0 2026-07-13 07:32 UTC

This package is auto-updated.

Last update: 2026-07-13 07:36:41 UTC


README

UI Profiler

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

PHP Version Symfony
CI
Release Downloads License

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

Maintainer CSS (Sass pipeline)

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

Author Ship
assets/scss/shell-chrome.scss assets/styles/shell-chrome.css
assets/scss/wdt-toolbar.scss assets/styles/wdt-toolbar.css
assets/scss/wdt-critical.scss assets/styles/wdt-critical.css
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

Path Role
assets/controllers/ Stimulus controllers (dialog, tabs, table-search) — AssetMapper + UiProfilerExtension
assets/js/shell.js Profiler shell ES module (UiProfilerShell)
assets/js/wdt.js Web Debug Toolbar ES module (UiProfilerWdt)
assets/js/panels/*.js Collector panel boot scripts (time, form, events)

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

License

MIT