Zhortein · Zhortein · May 12, 2026 · May 12, 2026
diff --git a/README.md b/README.md
@@ -110,6 +110,7 @@ With runtime options:
 - [Routes](docs/routes.md)
 - [Stimulus and AssetMapper integration](docs/stimulus-assetmapper.md)
 - [Table controls and interactions](docs/table-controls.md)
+- [UI/UX rendering customization](docs/ui-ux-rendering.md)
 - [Column visibility and preferences](docs/preferences.md)
 - [User-facing filters](docs/filters.md)
 - [Server-side exports](docs/exports.md)

diff --git a/docs/actions-and-cells.md b/docs/actions-and-cells.md
@@ -645,6 +645,12 @@ $definition->setOption('rowActionDisplayMode', 'list');
 
 This can be useful for custom layouts or narrow responsive displays.
 
+## UI/UX rendering customization
+
+Action icons, row action display modes, boolean display modes and control layout options are documented in [`ui-ux-rendering.md`](ui-ux-rendering.md).
+
+This document is the recommended entry point for visual and ergonomic customization.
+
 ## Recommended usage
 
 Use the current action system for simple back-office actions:

diff --git a/docs/architecture.md b/docs/architecture.md
@@ -1258,6 +1258,22 @@ These options append classes and do not replace the bundle's default Bootstrap c
 
 This allows host applications to apply project-specific styling without overriding templates.
 
+### UI/UX rendering customization
+
+UI/UX rendering customization is documented in `docs/ui-ux-rendering.md`.
+
+The documentation covers:
+
+- optional action icons;
+- action icon position;
+- row action display modes;
+- boolean cell display modes;
+- sortable header indicators;
+- configurable control layout;
+- additional root/wrapper/table CSS classes;
+- Bootstrap table variants;
+- current limitations.
+
 ### Column header filter dropdown design
 
 Column header filter UI is designed in `docs/decisions/0006-column-header-filter-dropdowns.md`.

diff --git a/docs/index.md b/docs/index.md
@@ -40,6 +40,7 @@ This bundle is a Symfony 8+ datatable bundle for Bootstrap-first business tables
 - [Cell template reference](cell-templates.md)
 - [Theming and rendering customization](theming.md)
 - [Optional icon rendering strategy](icons.md)
+- [UI/UX rendering customization](ui-ux-rendering.md)
 
 ## Actions and security
 

diff --git a/docs/roadmap.md b/docs/roadmap.md
@@ -475,26 +475,9 @@ Known limitations before first alpha:
 
 ---
 
-# Next roadmap direction
-
-After milestone 0.14, the project enters a release preparation phase.
-
-## Recommended next step: first alpha preparation
-
-Before adding more features, the recommended next milestone is:
-
-```text
-0.15 - First alpha preparation
-```
-
-Goal:
-
-```text
-Validate the bundle in a fresh Symfony application and prepare the first public alpha tag.
-```
-
-Suggested work:
+## 0.15 - First alpha preparation ✅
 
+Delivered:
 - run a fresh Symfony 8 smoke test;
 - install the bundle through a path repository;
 - test the minimal array datatable example;
@@ -512,13 +495,47 @@ Suggested work:
 - prepare `CHANGELOG.md` for `v0.1.0-alpha.1`;
 - decide whether to publish to Packagist immediately or after smoke-test fixes.
 
-## After alpha
+`v0.1.0-alpha.1` is released.
 
-After a first alpha exists, possible next feature milestones are:
+---
 
-### 0.16 - Stabilization from smoke tests
+## 0.16 - UI/UX rendering polish ✅
 
-Fix issues discovered during fresh-app integration.
+Delivered:
+
+- Optional action icon rendering improvements.
+- Action icon positioning.
+- Row action display modes:
+    - inline;
+    - dropdown;
+    - list.
+- Boolean cell display modes:
+    - badge;
+    - icon;
+    - switch;
+    - text.
+- Polished sortable header rendering.
+- Configurable datatable control layout.
+- Additional root, wrapper and table CSS class options.
+- Column header filter dropdown design decision.
+- UI/UX rendering customization documentation.
+
+Main outcome:
+
+```text
+The datatable UI is now more adaptable to real business application layouts while remaining Bootstrap-first and dependency-light.
+```
+
+Current limitations:
+
+- no icon provider abstraction;
+- no icon-only action mode;
+- no modal confirmation;
+- no Tailwind theme;
+- no column header filter implementation yet;
+- no frontend automated test suite.
+
+---
 
 ### 0.17 - Symfony Flex recipe decision
 

diff --git a/docs/table-controls.md b/docs/table-controls.md
@@ -368,6 +368,10 @@ The design keeps filtering close to the column while avoiding a crowded toolbar.
 
 This feature is not implemented yet. It is documented as an upcoming UI pattern in [`decisions/0006-column-header-filter-dropdowns.md`](decisions/0006-column-header-filter-dropdowns.md).
 
+## UI/UX rendering customization
+
+For a consolidated reference about table controls layout, sortable headers, boolean display modes and additional CSS classes, see [`ui-ux-rendering.md`](ui-ux-rendering.md).
+
 ## Related documentation
 
 - [`stimulus-assetmapper.md`](stimulus-assetmapper.md)

diff --git a/docs/theming.md b/docs/theming.md
@@ -321,6 +321,20 @@ For project-specific styling, applications can append CSS classes without overri
 
 The bundle keeps its default Bootstrap classes and appends the provided classes.
 
+## UI/UX rendering customization
+
+The UI/UX customization options are summarized in [`ui-ux-rendering.md`](ui-ux-rendering.md).
+
+It covers:
+
+- action icons;
+- action display modes;
+- boolean display modes;
+- sortable header indicators;
+- control layout;
+- additional CSS classes;
+- Bootstrap table variants.
+
 ## Future direction
 
 Potential future work: