Document about alternative JS assets installation with npm packages

Author: Kocal

README.md

@@ -2,6 +2,25 @@
 
 [Google Maps](https://developers.google.com/maps/documentation/javascript/overview) integration for Symfony UX Map.
 
+## Installation
+
+Install the bridge using Composer and Symfony Flex:
+
+```shell
+composer require symfony/ux-google-map
+```
+
+If you're using WebpackEncore, install your assets and restart Encore (not
+needed if you're using AssetMapper):
+
+```shell
+npm install --force
+npm run watch
+```
+
+> [!NOTE]
+> Alternatively, [@symfony/ux-google-map package](https://www.npmjs.com/package/@symfony/ux-google-map) can be used to install the JavaScript assets without requiring PHP.
+
 ## DSN example
 
 ```dotenv

assets/README.md

@@ -1,10 +1,18 @@
 # @symfony/ux-google-map
 
-Easily embed interactive maps in your Symfony application.
+JavaScript assets of the [symfony/ux-google-map](https://packagist.org/packages/symfony/ux-google-map) PHP package.
 
-**ℹ️ Direct installation of this package is for advanced users only.** We strongly recommend installing it through the PHP package [symfony/ux-google-map](https://packagist.org/packages/symfony/ux-google-map) in a Symfony application with Flex enabled.
+## Installation
 
-If you still want to install this package directly, **make sure its version exactly matches [symfony/ux-google-map](https://packagist.org/packages/symfony/ux-google-map) PHP package version.**
+This npm package is **reserved for advanced users** who want to decouple their JavaScript dependencies from their PHP dependencies (e.g., when building Docker images, running JavaScript-only pipelines, etc.).
+
+We **strongly recommend not installing this package directly**, but instead  install the PHP package [symfony/ux-google-map](https://packagist.org/packages/symfony/ux-google-map) in your Symfony application with [Flex](https://github.com/symfony/flex) enabled.
+
+If you still want to install this package directly, please make sure its version exactly matches [symfony/ux-google-map](https://packagist.org/packages/symfony/ux-google-map) PHP package version:
+```shell
+composer require symfony/ux-google-map:2.23.0
+npm add @symfony/[email protected]
+```
 
 ## Resources