From a66bb4e5a7f031345e24c32894f293daa9df8773 Mon Sep 17 00:00:00 2001
From: Javier Godoy <11554739+javier-godoy@users.noreply.github.com>
Date: Mon, 31 Mar 2025 14:25:22 -0300
Subject: [PATCH] docs(readme): document allowed-packages

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 652c3b4..18ac327 100644
--- a/README.md
+++ b/README.md
@@ -102,3 +102,15 @@ For a more comprehensive example, see `com.flowingcode.vaadin.addons.chipfield.D
         Binder<Planet> binder = new Binder<>();
         binder.bind(chf5,Planet::getConfiguration,Planet::setConfiguration);
         binder.setBean(p);
+
+## Special configuration when using Spring
+
+By default, Vaadin Flow only includes `com/vaadin/flow/component` to be always scanned for UI components and views. For this reason, the add-on might need to be allowed in order to display correctly. 
+
+To do so, just add `com.flowingcode` to the `vaadin.allowed-packages` property (Vaadin 14-23: `vaadin.whitelisted-packages`) in `src/main/resources/application.properties`, like:
+
+```
+vaadin.allowed-packages = com.vaadin,org.vaadin,dev.hilla,com.flowingcode
+```
+
+More information on Spring scanning configuration [here](https://vaadin.com/docs/latest/integrations/spring/configuration/#configure-the-scanning-of-packages).