diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5834a9f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+<img src="icon.png" alt="etherscan logo" width="96" height="96"/>
+
+# Etherscan Suggest
+
+Get in-line suggestions from [Etherscan](https://etherscan.io) search results via the **Search Keyword** (default: `eth`). Press <kbd>↩</kbd> to open the contract's page with your default web browser — both the contract's name and its address are valid inputs.
+
+![etherscan-workflow.png](/resources/etherscan-workflow.png)
+
+## Installation
+
+1. Go to the [**Releases**](https://github.com/zarifpour/alfred-etherscan-suggest/releases) page for this workflow.
+2. Download the latest version of the workflow by clicking on the `etherscan.suggest.alfredworkflow`.
+3. Double-click the file to install it in Alfred.
+4. Alfred will prompt you to add the workflow to your collection.
+
+That's it! Once the workflow is installed, you can use it by typing in the **Search Keyword** (default: `eth`) followed by a project's name or its address in Alfred.
+
+## Updating the Search Keyword
+
+1. Go to **Alfred Preferences**.
+2. Open the **Workflows** tab.
+3. Select **Etherscan Suggest**.
+4. Click **Configure Workflow...** to set the Search Keyword.
+
+## Credits
+
+This workflow is inspired by the [Google Suggest](https://alfred.app/workflows/alfredapp/google-suggest/) workflow created by Vítor Galvão.
+
+"This workflow was adapted with the help of ChatGPT, a large language model trained by OpenAI. ChatGPT provided guidance and support during the development process."
+
+If you liked this workflow, try out my other one: [You.com Suggest](https://github.com/zarifpour/alfred-you-suggest/tree/main).
+
+---
+
+Adapted with ❤️ by [Daniel Zarifpour](https://links.dev/z).