Update README.md

Author: AB-xdev

README.md

@@ -10,6 +10,29 @@ A simple Vaadin Flow component for filtering Grids.
 
 ![demo](assets/demo.png)
 
+> [!NOTE]
+> If you are looking for a more advanced component you may check out our [grid-filter](https://github.com/xdev-software/vaadin-grid-filter).
+
+## Usage
+
+Here is a very simple example how the FilterComponent can be used:
+```java
+Grid<Person> grid = createGrid();
+
+FilterComponent<Person> filter = new FilterComponent<>(grid)
+  .withFilter(new SimpleFilterField<>(Person::getLastName, "Lastname"));
+
+this.add(filter, grid);
+```
+
+To get started further it's recommended to have a look at the [demo](./vaadin-simple-grid-filter-demo).<br/>
+A description how to get it running can be found [below](#run-the-demo).
+
+> [!IMPORTANT]
+> This component is designed for "in memory" filtering of small to medium sized amounts of data.
+
+> [!NOTE]
+> Filtering multiple thousand items with complex filtering conditions can drastically impact performance and make the UI unresponsive!<br/> In these cases it's recommended to use backend filtering solutions like database queries or search engines like [ElasticSearch](https://en.wikipedia.org/wiki/Elasticsearch) in combination with a customized UI search framework. If you need help in implementing these feel free to [contact us](https://xdev.software/en/services/support).
 
 ## Installation
 [Installation guide for the latest release](https://github.com/xdev-software/vaadin-simple-grid-filter/releases/latest#Installation)