diff --git a/CHANGELOG.md b/CHANGELOG.md
index dcea2983..203f9ef3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,8 +5,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [0.5.0]
+### Improvements
+- the app is now modularized: **fpakman** (GUI), **fpakman_api** (set of abstraction classes to extend), **fpakman_flatpak** (adds support for Flatpaks), **fpakman_snap** (adds support for Snaps)
 ### Comments
-- Env variables / arguments FPAKMAN_SNAP / FPAKMAN_FLATPAK were removed. To disable a supported type, just uninstall its module.
+- env variables / arguments FPAKMAN_SNAP / FPAKMAN_FLATPAK were removed. To disable a supported type, just uninstall its module.
 
 ## [0.4.3]
 ### Improvements
diff --git a/README.md b/README.md
index 47673717..c6a27b3e 100644
--- a/README.md
+++ b/README.md
@@ -17,15 +17,32 @@ an application management panel where you can search, update, install and uninst
 - python-pip
 - python-pyqt5
 
+### Modularization
+**fpakman** is divided into:
+
+* Base modules:
+**fpakman** -> is the GUI.
+**fpakman_api** -> set of abstraction classes to extend and provide new packaging types support for the **fpakman**.
+
+* Extensions:
+**fpakman_flatpak** -> adds support for Flatpak applications
+**fpakman_snap** -> adds support for Snap applications
+...
+
+The extension modules are optional. You can install only the ones you want **fpakman** to work with.
+
 ### Distribution
 **PyPi**
 ```
 sudo pip3 install fpakman
 ```
+Optional (extensions):
+```
+sudo pip3 install fpakman_snap fpakman_flatpak
+```
 
 **AUR**
-
-As **fpakman** package. There is also a staging version (**fpakman-staging**) but is intended for testing and may not work properly.
+As **fpakman**. There is also a staging version of **fpakman** (**fpakman-staging**) but is intended for testing and may not work properly.
 
 
 ### Manual installation: