From f7062b249586dc131f07dee86e1e91efed5215af Mon Sep 17 00:00:00 2001
From: Eliad Shahar <54673680+Zie619@users.noreply.github.com>
Date: Wed, 14 May 2025 11:45:06 +0300
Subject: [PATCH] Update README.md

---
 README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 54 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index c6406c6..fe92486 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,54 @@
-# n8n-workflows
-all of the workflows of n8n i could find (also from the site itself)
+🧠 n8n Workflow Collection
+This repository contains a collection of n8n workflows gathered from multiple sources, including:
+
+Workflows exported from the n8n.io website and community forum
+
+Publicly shared examples found across the web (GitHub, blogs, etc.)
+
+The goal is to provide a useful resource for inspiration, learning, and reuse in your own n8n projects.
+
+📂 Folder Structure
+Each .json file represents a single exported workflow.
+
+Files are named either based on their original title or source.
+
+You may also find .txt files that were converted into .json (see below).
+
+🔄 TXT to JSON Conversion
+Some workflows were originally saved as .txt files or copied from online sources. A script was used to:
+
+Detect .txt files
+
+Attempt to parse them as JSON or structured key-value pairs
+
+Convert them to valid .json format
+
+If you’re looking to run the conversion yourself, check out convert_txt_to_json.py included in this repo.
+
+🛠 Usage Instructions
+To import a workflow into your own n8n instance:
+
+Open your n8n Editor UI
+
+Click on the menu (☰) in the top right → Import workflow
+
+Choose a .json file from this folder
+
+Click "Import" to load the workflow
+
+Make sure to review and modify credentials or webhook URLs as needed before running.
+
+🤝 Contribution
+Found a cool workflow or created your own?
+Feel free to contribute by adding it to this collection!
+
+Just make sure to:
+
+Name the file descriptively
+
+Include a short comment at the top with the original source if applicable
+
+⚠️ Disclaimer
+All workflows here are shared as-is.
+Always inspect and test them in a safe environment before using them in production.
+