Installation
Pictum supports PHP 8.2+ and Laravel 12 or 13. Install the package in your application with Composer; Laravel discovers its service provider automatically.Agent skill
Install the Laravel integration skill for coding agents that support Agent Skills:Configuration
The package useshttps://pictum.dev/v1 by default. Set PICTUM_BASE_URL for another deployment and PICTUM_CACHE_STORE to choose the store used for fetched icon markup.
Publish the configuration file when you need to customize these settings:
Icons
Use the Blade component in views. Use the facade when application code needs the icon URL or canonical SVG markup.Avatars
Use the Blade component for profile images in views. The facade generates portrait and generated avatar URLs and retrieves canonical SVG for generated avatars.QR codes
Use the Blade component for scannable text or URLs. Use the facade when application code needs the image URL or canonical SVG.Placeholders
Use the Blade component for square or custom-dimension images. Use the facade when application code needs the selected image URL or SVG markup.base-url to override the configured deployment for one asset. Facade methods accept the equivalent baseUrl named argument.
The icon component fetches and caches canonical markup before rendering inline SVG. Avatar, QR code, and placeholder components render image URLs. Reading an asset’s url property makes no request; svg() fetches canonical SVG markup and is unavailable for portrait avatars.