# Symfony AssetMapper

Symfony component that maps asset directories to versioned public files and loads JavaScript through browser importmaps, without a bundler.


Source: https://findsoftware.frbit.cloud/asset-mapper/
Last reviewed: 2026-10-28
Listed since: 2026-10-28

## Record

### Links

- home: https://symfony.com/asset-mapper
- repository: https://github.com/symfony/asset-mapper
- docs: https://symfony.com/doc/current/frontend/asset_mapper.html

### Identity

- status: active
- maintainer: Fabien Potencier
- maintainerType: individual
- parent: unknown
- firstRelease: 2023
- hqCountry: unknown

### Kind

- category: build-tool
- hosting: not applicable
- language: php
- runtime: php
- runtimeMin: php 8.4
- basedOn: symfony

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: static
- renderingModes: not applicable
- installMethod: composer require symfony/asset-mapper symfony/asset symfony/twig-pack

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 8
- latestReleaseDate: 2026-10-14

### Adoption

- githubStargazers: 173
- packagistDownloads: 12580866
- npmWeeklyDownloads: not applicable
- contributors: 53
- pluginCount: unknown
- packagistMonthlyDownloads: 1357726
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 23
- dependentPackages: 32

### Sources

- urls: https://symfony.com/asset-mapper (read 2026-10-28)
- urls: https://api.github.com/repos/symfony/asset-mapper (read 2026-10-28)
- urls: https://symfony.com/doc/current/frontend/asset_mapper.html (read 2026-10-28)
- maintainer: https://raw.githubusercontent.com/symfony/asset-mapper/8.2/LICENSE (read 2026-10-28)
- maintainerType: https://raw.githubusercontent.com/symfony/asset-mapper/8.2/LICENSE (read 2026-10-28)
- language: https://api.github.com/repos/symfony/asset-mapper (read 2026-10-28)
- runtime: https://raw.githubusercontent.com/symfony/asset-mapper/v8.1.9/composer.json (read 2026-10-28)
- runtimeMin: https://raw.githubusercontent.com/symfony/asset-mapper/v8.1.9/composer.json (read 2026-10-28)
- category: https://raw.githubusercontent.com/symfony/asset-mapper/8.2/README.md (read 2026-10-28)
- basedOn: https://symfony.com/asset-mapper (read 2026-10-28)
- installMethod: https://symfony.com/doc/current/frontend/asset_mapper.html (read 2026-10-28)
- runsAs: https://symfony.com/doc/current/frontend/asset_mapper.html (read 2026-10-28)
- license: https://packagist.org/packages/symfony/asset-mapper.json (read 2026-10-28)
- licenseModel: https://raw.githubusercontent.com/symfony/asset-mapper/8.2/LICENSE (read 2026-10-28)
- firstRelease: https://api.github.com/repos/symfony/asset-mapper/releases (read 2026-10-28)
- currentMajor: https://api.github.com/repos/symfony/asset-mapper/releases (read 2026-10-28)
- latestReleaseDate: https://api.github.com/repos/symfony/asset-mapper/releases (read 2026-10-28)
- githubStargazers: https://api.github.com/repos/symfony/asset-mapper (read 2026-10-28)
- contributors: https://api.github.com/repos/symfony/asset-mapper/contributors (read 2026-10-28)
- packagistDownloads: https://packagist.org/packages/symfony/asset-mapper.json (read 2026-10-28)
- packagistMonthlyDownloads: https://packagist.org/packages/symfony/asset-mapper.json (read 2026-10-28)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/packagist.org/packages/symfony%2Fasset-mapper (read 2026-10-28)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/packagist.org/packages/symfony%2Fasset-mapper (read 2026-10-28)

## Notes

Symfony AssetMapper is the component that the Symfony framework uses to serve application assets without a bundler. It maps directories, such as assets/, to public paths and gives each file a version hash in its name. JavaScript modules load through a browser importmap, so one module can import another or a third-party package without a build step, and a Twig call renders the map into the page.

The component is installed with Composer. In development, the Symfony application returns the versioned URLs itself. Before deployment, the asset-map:compile command writes the final files into public/assets, where the web server serves them directly.

## Worth knowing

The component does not minify assets. The project points to separate bundles for Sass, TypeScript, Tailwind CSS and minification, and to a dedicated bundle for linting.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0