diff --git a/docs/ui-components/index.mdx b/docs/ui-components/index.mdx
index c04e989b4..883b6d412 100644
--- a/docs/ui-components/index.mdx
+++ b/docs/ui-components/index.mdx
@@ -1,6 +1,12 @@
 # UI Components
 
-Chakra ui components for easily integrating Vocdoni services.
+The [UI Components](https://github.com/vocdoni/ui-components) library is a set of react providers and components that abstract away the SDK and enable easy client usage of Vocdoni functionality. 
+
+:::tip examples
+You can see examples of the [account](/ui-components/account), [election](/ui-components/election), [layout](/ui-components/layout), and [organization](/ui-components/organization) components, as well as the [react providers](/ui-components/react-providers), in the sub-pages of this section.
+
+These examples use [mock-service-workers](https://mswjs.io/) to mock API responses in order to show how components would function in a real election where the client is an eligible voter. 
+:::
 
 ## Installing