diff --git a/README.md b/README.md
index 664c29a..1efde3c 100644
--- a/README.md
+++ b/README.md
@@ -27,11 +27,22 @@ module is built to work out of the box with some minor config tweaks and it come
 We considered that RBAC was essential to be included into any user management module, even if you simply use one user 
 with `admin` role, its much better to actually work with RBAC just in case your application scales in the future.
 
-## Documentation 
+## Boostrap 4 and 5 support
+
+With the release of 1.6, contributors started implementing changes for supporting newer versions of the Boostrap library,
+being Usuario stuck at 3.
+
+Up until around May 2023, the `master` branch will remain stable, so devs who in these years relied on it for
+deployment can have time to migrate to a stable version.
+BS5 development is ongoing on branch [`2.0.0-dev`](https://github.com/2amigos/yii2-usuario/tree/v2.0.0-dev),
+which will eventually be merged in `master` around May.
+
+You can check issues #476, #488, #500 for updates, or the [branch itself](https://github.com/2amigos/yii2-usuario/tree/v2.0.0-dev).
+
+## Documentation
 
 You can read the latest docs on [http://yii2-usuario.readthedocs.io/en/latest/](http://yii2-usuario.readthedocs.io/en/latest/)
 
-
 ## Need Help? 
 
 If you have issues, please use the Gitter room of this repository [https://gitter.im/2amigos/yii2-usuario](https://gitter.im/2amigos/yii2-usuario).