[Docs] Enhance README(s) with logo and better text

Author: Kocal

README.md

@@ -1,11 +1,41 @@
-# Symfony Reprise
+<h1 align="center">
+  <img src="doc/symfony-reprise.svg" alt="Symfony Reprise" height="32" align="top"> Symfony Reprise
+</h1>
 
-[![npm version](https://img.shields.io/npm/v/@symfony%2Freprise?color=crimson&label=)](https://www.npmjs.com/package/@symfony/reprise)
-[![npm downloads](https://img.shields.io/npm/dm/@symfony%2Freprise?color=crimson&label=)](https://www.npmjs.com/package/@symfony/reprise)
-[![license](https://img.shields.io/npm/l/@symfony%2Freprise?color=crimson&label=)](https://www.npmjs.com/package/@symfony/reprise)
+<p align="center">
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/v/@symfony%2Freprise?color=crimson&label=" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/dm/@symfony%2Freprise?color=crimson&label=" alt="npm downloads"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/l/@symfony%2Freprise?color=crimson&label=" alt="license"></a>
+</p>
 
-**EXPERIMENTAL** This bundle is experimental and is likely to change, or even change drastically.
+<p align="center">
+  <a href="https://packagist.org/packages/symfony/reprise"><img src="https://img.shields.io/packagist/v/symfony/reprise?color=crimson&label=" alt="Packagist version"></a>
+  <a href="https://packagist.org/packages/symfony/reprise"><img src="https://img.shields.io/packagist/dm/symfony/reprise?color=crimson&label=" alt="Packagist downloads"></a>
+  <a href="https://packagist.org/packages/symfony/reprise"><img src="https://img.shields.io/packagist/php-v/symfony/reprise?color=crimson&label=php" alt="PHP version"></a>
+</p>
 
-Webpack Encore gave Symfony first-class asset integration for Webpack. Symfony Reprise gives you the same integration for **Vite** and **Rsbuild**.
+<p align="center">
+  Webpack Encore gave Symfony first-class asset integration for Webpack.<br>
+  Symfony Reprise brings the same to <strong>Vite</strong> and <strong>Rsbuild</strong>.
+</p>
+
+> [!WARNING]
+> **Experimental** this bundle is experimental and is likely to change, or even change drastically.
+
+Symfony Reprise covers only the Symfony-side glue the bundlers leave out:
+
+- 🎯 **Multiple entries**: build several independent entry points from one config
+- 📄 **`entrypoints.json`**: generated in both build and dev-server modes
+- 🗺️ **`manifest.json`**: maps each logical filename to its hashed URL
+- 🔖 **Asset versioning**: content-hash cache busting, wired into the manifest
+- 🔥 **Dev server & HMR**: points Twig at the running Vite/Rsbuild server
+- 🧩 **Symfony UX / Stimulus**: registers `controllers.json` and local controllers, eager or lazy
+- 🌐 **CDN support**: absolute `publicPath` *(planned)*
+- 🛡️ **Subresource Integrity**: SRI hashes in `entrypoints.json` *(planned)*
+- 📦 **Shared runtime chunk**: one runtime shared across entries *(planned)*
+
+Vite and Rsbuild already handle **Sass/Less/PostCSS**, **TypeScript**, **JSX/Vue/Svelte**, **code splitting**, **content hashing**, **source maps**, **minification** and **HMR** on their own, so Symfony Reprise does not reimplement any of that.
+
+It generates the Encore-compatible `entrypoints.json` and `manifest.json` that WebpackEncoreBundle's Twig helpers (`encore_entry_script_tags()`, `encore_entry_link_tags()`) read, wires up the native dev server, and turns your Stimulus controllers into a running application.
 
 [Read the documentation](doc/index.rst)

assets/README.md

@@ -0,0 +1,52 @@
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/symfony/reprise/main/doc/symfony-reprise.svg" alt="Symfony Reprise" height="32" align="top"> @symfony/reprise
+</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/v/@symfony%2Freprise?color=crimson&label=" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/dm/@symfony%2Freprise?color=crimson&label=" alt="npm downloads"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/node/v/@symfony%2Freprise?color=crimson&label=node" alt="node version"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/l/@symfony%2Freprise?color=crimson&label=" alt="license"></a>
+</p>
+
+The JavaScript half of **[Symfony Reprise](https://github.com/symfony/reprise)**: a Vite and Rsbuild plugin that generates the `entrypoints.json` and `manifest.json` the Symfony bundle reads.
+
+Use it alongside the `symfony/reprise` Composer bundle. The plugin builds your assets and writes the manifests; the bundle renders the matching `<script>` and `<link>` tags from them.
+
+## Installation
+
+```bash
+npm install @symfony/reprise --save-dev
+```
+
+## Usage
+
+Vite:
+
+```js
+// vite.config.ts
+import { defineConfig } from 'vite'
+import Symfony from '@symfony/reprise/vite'
+
+export default defineConfig({
+  plugins: [Symfony({ /* options */ })],
+})
+```
+
+Rsbuild:
+
+```js
+// rsbuild.config.ts
+import { defineConfig } from '@rsbuild/core'
+import Symfony from '@symfony/reprise/rsbuild'
+
+export default defineConfig({
+  plugins: [Symfony({ /* options */ })],
+})
+```
+
+See the [full documentation](https://github.com/symfony/reprise/blob/main/doc/index.rst) for entrypoints, manifest, dev server and Stimulus setup.
+
+## License
+
+[MIT](./LICENSE)

assets/package.json

@@ -46,6 +46,9 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=22.18"
+  },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown -w",