diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3b0cdd7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,51 @@
+# StorageMailNotifierFunction
+This repository contains Terraform code and a configured CI/CD pipeline to deploy infrastructure on Azure for the [StorageMailNotifier](https://github.com/Raffael-Eloi/storageMailNotifier).
+The StorageMailNotifier is an Azure Function that triggers when a file is uploaded to a Blob Storage container, sending an email with the file information.
+
+# Architecture preview
+![image](https://github.com/Raffael-Eloi/storageMailNotifierFunction/assets/51720161/5946b9c2-d19a-49c4-8cb3-7ac5ea984f5d)
+
+# Prerequisites
+Ensure you have the following installed before proceeding:
+- [Terraform](https://developer.hashicorp.com/terraform/install?product_intent=terraform)
+- [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli)
+- Access to an Azure account with permissions to create resources
+
+## Running Locally
+
+To deploy the infrastructure locally, follow these steps:
+
+1. **Initialize Terraform:**
+   ```sh
+   terraform init
+   ```
+   This command prepares your working directory for other Terraform commands.
+
+2. **Plan the Deployment:**
+   ```sh
+   terraform plan
+   ```
+   This command displays the changes required by the current configuration. It provides a preview of what will be added, modified, or deleted in your infrastructure.
+
+3. **Apply the Deployment:**
+   ```sh
+   terraform apply
+   ```
+   This command creates or updates the infrastructure. You will need to type `yes` and press enter to confirm the changes.
+
+## Running in the CI/CD Pipeline
+
+To deploy the infrastructure using the CI/CD pipeline, follow these steps:
+
+1. **Create Azure Credentials:**
+   Ensure you have created and configured your Azure credentials. This typically involves creating a service principal and setting the necessary environment variables (`AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_SUBSCRIPTION_ID`).
+
+2. **Modify Configuration:**
+   Edit the `resource_group.tf` file to specify the name of your Azure resource group.
+
+3. **Pipeline Execution:**
+   The CI/CD pipeline configuration is set up to use these credentials and deploy the infrastructure. Ensure your pipeline is configured to use these environment variables and that it triggers on the necessary events (e.g., push to the main branch).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.