diff --git a/README.md b/README.md
index 562cd67..09aa480 100644
--- a/README.md
+++ b/README.md
@@ -11,31 +11,74 @@ and the Flutter guide for
 [developing packages and plugins](https://flutter.dev/developing-packages).
 -->
 
-![languagetool popup presentation](readme/languagetool.gif)
+# LanguageTool TextField
 
-TODO: Put a short description of the package here that helps potential users
-know whether this package might be useful for them.
+Providing powerful spell checking and grammar correction capabilities.
+
+<div>
+<img src="doc/misspeling_langtool.png" width="310" height="667">
+&nbsp
+&nbsp
+<img src="doc/typo_langtool.png" width="310" height="667">
+&nbsp
+&nbsp
+<img src="doc/uncategorized_langtool.png" width="310" height="667">
+</div>
 
 ## Features
 
-TODO: List what your package can do. Maybe include images, gifs, or videos.
+The LanguageTool TextField package is a spell-checker designed for Flutter apps. It integrates with the LanguageTool API to offer real-time spell-checking capabilities. This package will enhance text input accuracy by automatically detecting and highlighting spelling errors as users type. 
+
+It's particularly useful for apps that require precise text input, like chat or note-taking apps. By using the LanguageTool TextField package, developers can improve the user experience by providing an intuitive and reliable spell-checking feature.
+
 
 ## Getting started
 
-TODO: List prerequisites and provide or point to information on how to
-start using the package.
+1. Add dependency:
 
-## Usage
+```dart
+flutter pub add language_tool_textfield
+```
 
-TODO: Include short and useful examples for package users. Add longer examples
-to `/example` folder.
+2. Import the package:
 
 ```dart
-const like = 'sample';
+import 'package:language_tool_textfield/language_tool_textfield.dart';
 ```
 
-## Additional information
 
-TODO: Tell users more about the package: where to find more information, how to
-contribute to the package, how to file issues, what response they can expect
-from the package authors, and more.
+## Quick Start
+To start using the plugin, copy this code or follow the example project in 'languagetool_textfield/example'
+
+```dart
+// Create a base API client
+final _languageTool = LanguageToolClient();
+
+// Add input debouncing
+final _debouncedLangService = DebounceLangToolService(
+  LangToolService(_languageTool),
+  const Duration(milliseconds: 500),
+);
+
+// Create a text controller for the Widget
+final _controller = ColoredTextEditingController(
+    languageCheckService: _debouncedLangService
+);
+
+// Use the text field widget in your layout
+child: LanguageToolTextField(
+  style: const TextStyle(),
+  decoration: const InputDecoration(),
+  coloredController: _controller,
+  mistakePopup: MistakePopup(popupRenderer: PopupOverlayRenderer()),
+);
+
+// Don't forget to dispose the controller
+_controller.dispose();
+```
+
+## Current issues
+
+Current issues list [is here](https://github.com/solid-software/languagetool_textfield/issues).\
+Found a bug? [Open the issue](https://github.com/solid-software/languagetool_textfield/issues/new).
+
diff --git a/doc/misspeling_langtool.png b/doc/misspeling_langtool.png
new file mode 100644
index 0000000..f7fd32b
Binary files /dev/null and b/doc/misspeling_langtool.png differ
diff --git a/doc/typo_langtool.png b/doc/typo_langtool.png
new file mode 100644
index 0000000..6fbfefc
Binary files /dev/null and b/doc/typo_langtool.png differ
diff --git a/doc/uncategorized_langtool.png b/doc/uncategorized_langtool.png
new file mode 100644
index 0000000..a454652
Binary files /dev/null and b/doc/uncategorized_langtool.png differ
diff --git a/readme/languagetool.gif b/readme/languagetool.gif
deleted file mode 100644
index c4bdc72..0000000
Binary files a/readme/languagetool.gif and /dev/null differ