Skip to main content
SSR

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 uses https://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.
Blade components accept 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.