tidy #8 [Docs] Enhance README(s) with logo and better text (Kocal)

This PR was merged into the main branch.

Discussion
----------

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

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| Deprecations? | no
| Issues        | Fix #... <!-- prefix each issue number with "Fix #", no need to open an issue if none exists, explain below instead -->
| License       | MIT

<!--
Replace this notice with a description of your feature or bugfix.
This helps reviewers and is a good starting point for the documentation.

Additionally (see https://symfony.com/releases):
 - Always add tests and ensure they pass.
 - For new features, provide some code snippets to help understand usage.
 - Features and deprecations must be submitted against the main branch.
 - Update or add documentation as required (we can help!).
 - Never break backward compatibility (see https://symfony.com/bc).
-->

Commits
-------

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

Author: Kocal

README.md

@@ -1,11 +1,41 @@
-# Symfony Reprise
+<p align="center"><a href="https://symfony.com" target="_blank">
+    <img src="https://symfony.com/logos/symfony_dynamic_01.svg" alt="Symfony Logo">
+</a></p>
 
-[![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)
+<h3 align="center">
+    <img src="doc/symfony-reprise.svg" alt="Symfony Reprise" height="32" align="center"> Symfony Reprise: Webpack Encore's heritage, for modern bundlers
+</h3>
 
-**EXPERIMENTAL** This bundle is experimental and is likely to change, or even change drastically.
+<p align="center">
+  <a href="https://github.com/symfony/reprise/releases"><img src="https://img.shields.io/github/v/tag/symfony/reprise?sort=semver&label=tag&color=crimson" alt="Latest tag"></a>
+  <a href="https://packagist.org/packages/symfony/reprise"><img src="https://img.shields.io/packagist/php-v/symfony/reprise?label=php&color=crimson" alt="PHP version"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/node/v/@symfony%2Freprise?label=node&color=crimson" alt="Node version"></a>
+  <a href="https://github.com/symfony/reprise/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/symfony/reprise/ci.yml?branch=main&label=CI" alt="CI"></a>
+  <a href="https://github.com/symfony/reprise/blob/main/LICENSE"><img src="https://img.shields.io/github/license/symfony/reprise?label=license&color=crimson" alt="License"></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">
+  <a href="https://github.com/symfony/webpack-encore">Webpack Encore</a> 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](https://github.com/symfony/webpack-encore-bundle)'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,56 @@
+<p align="center"><a href="https://symfony.com" target="_blank">
+    <img src="https://symfony.com/logos/symfony_dynamic_01.svg" alt="Symfony Logo">
+</a></p>
+
+<h3 align="center">
+    <img src="https://raw.githubusercontent.com/symfony/reprise/main/doc/symfony-reprise.svg" alt="Symfony Reprise" height="32" align="center"> Symfony Reprise: Webpack Encore's heritage, for modern bundlers
+</h3>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/npm/v/@symfony%2Freprise?label=npm&color=crimson" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@symfony/reprise"><img src="https://img.shields.io/node/v/@symfony%2Freprise?label=node&color=crimson" alt="Node version"></a>
+  <a href="https://github.com/symfony/reprise/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/symfony/reprise/ci.yml?branch=main&label=CI" alt="CI"></a>
+  <a href="https://github.com/symfony/reprise/blob/main/assets/LICENSE"><img src="https://img.shields.io/github/license/symfony/reprise?label=license&color=crimson" 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](https://packagist.org/packages/symfony/reprise). 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",

doc/index.rst

@@ -5,24 +5,30 @@ Symfony Reprise
 or even change drastically.
 
 Webpack Encore gave Symfony first-class asset integration for Webpack.
-Symfony Reprise gives you the same integration for `Vite`_ and `Rsbuild`_.
+Symfony Reprise brings the same to `Vite`_ and `Rsbuild`_.
 
 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 only covers the Symfony-side integration that
-bundlers do not provide out of the box:
-
-- Multiple entries
-- ``entrypoints.json`` generation (build and dev-server modes)
-- ``manifest.json`` generation
-- Asset versioning wired into the manifest
-- CDN support (absolute ``publicPath``) *(planned)*
-- Dev server and HMR integration
-- Subresource Integrity (SRI) hashes *(planned)*
-- Shared runtime chunk across entries *(planned)*
-- Symfony UX / Stimulus controllers (``controllers.json`` and local
-  ``assets/controllers/``)
+reimplement any of that. It 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 and 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)*
+
+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.
 
 Installation
 ------------