Installation

Requirements

• PHP 8.2+
• Laravel 10.x, 11.x, or 12.x

Install via Composer

composer require laratusk/larasvg

Publish Configuration

php artisan vendor:publish --tag=larasvg-config

This will create config/svg-converter.php with default settings.

Setup Providers

Run the interactive setup command to detect and install conversion providers:

php artisan larasvg:setup

The command will:

1. Detect your operating system (macOS, Ubuntu, Fedora, Arch, Alpine, etc.)
2. Check which providers are already installed and show their versions
3. Prompt you to select a provider to install
4. Install the selected provider using the appropriate package manager
5. Suggest the .env configuration to use

  LaraSVG — Provider Setup

  System: macos (macos)

  ● Inkscape ··· Inkscape 1.4.3 (0d15f75, 2025-12-25) /opt/homebrew/bin/inkscape
  ○ Resvg ····· not installed

  Which provider would you like to install?
  › Inkscape — already installed (Inkscape 1.4.3)        (disabled)
    Resvg — PNG — fast, lightweight
    Skip — I'll install manually later

Already-installed providers are shown but cannot be selected.

Manual Installation

You can install providers manually using the bundled shell script:

# Show status
./vendor/laratusk/larasvg/bin/install.sh

# Install a specific provider
./vendor/laratusk/larasvg/bin/install.sh resvg
./vendor/laratusk/larasvg/bin/install.sh inkscape
./vendor/laratusk/larasvg/bin/install.sh rsvg-convert

Installing Resvg

macOS

brew install resvg

Ubuntu/Debian

cargo install resvg

Arch

pacman -S resvg

Installing Inkscape

macOS

brew install --cask inkscape

Ubuntu/Debian

sudo apt install inkscape

Arch

pacman -S inkscape

Installing rsvg-convert

macOS

brew install librsvg

Ubuntu/Debian

sudo apt install librsvg2-bin

Fedora/RHEL

sudo dnf install librsvg2-tools

Arch

sudo pacman -S librsvg

Alpine

apk add rsvg-convert

Installing CairoSVG

macOS

brew install cairo libffi
pipx install cairosvg

Ubuntu/Debian

sudo apt install libcairo2-dev pkg-config python3-dev
pip3 install cairosvg

Fedora/RHEL

sudo dnf install cairo-devel pkg-config python3-devel
pip3 install cairosvg

Arch

sudo pacman -S python-cairosvg

Alpine

apk add cairo-dev
pip3 install cairosvg