> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laravelshopper.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Requirements

> Server and package requirements for running Shopper.

Shopper is a Laravel package and shares the same server requirements as Laravel itself. To manipulate images (resize, crop, etc), you will also need the GD Library or ImageMagick.

## Server Requirements

* PHP 8.3+
* MySQL 8+ / MariaDB 10.2+ / PostgreSQL 15+

### PHP Extensions

The following PHP extensions are required:

| Extension         | Purpose                                                            |
| ----------------- | ------------------------------------------------------------------ |
| `intl`            | Currency formatting, locale support, and internationalization      |
| `gd` or `imagick` | Image manipulation for product, category, and brand media          |
| `soap`            | Carrier API calls (UPS, FedEx, USPS) for shipping rate calculation |

<Note>
  Most PHP installations include `intl` and `gd` by default. The `soap` extension may need to be installed separately depending on your hosting environment.
</Note>

## Package Requirements

| Package  | Version              |
| -------- | -------------------- |
| Laravel  | 11.28+ / 12.x / 13.x |
| Filament | 4.11+                |

Shopper's Laravel version support follows Filament's compatibility. If Filament supports a Laravel version, Shopper supports it too.

## Development Environments

### Laravel Herd

[Laravel Herd](https://herd.laravel.com/) is the recommended development environment for both macOS and Windows. It provides PHP, Nginx, and database services with zero configuration. Herd includes all required PHP extensions out of the box.

### Laravel Valet

[Laravel Valet](https://laravel.com/docs/valet) is a lightweight development environment for macOS. It maps all subdirectories in a directory (such as `~/Sites`) to `.test` domains. You can share your sites publicly using local tunnels.

### Docker

Any Docker setup that satisfies the PHP and database requirements will work. The [Shopper demo store](https://github.com/shopperlabs/demo.laravelshopper.dev) uses Docker with FrankenPHP (Laravel Octane) as a reference.