diff --git a/.vscode/settings.json b/.vscode/settings.json
index b2f1b9b28..758d99af1 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -114,5 +114,13 @@
 
   // Enable/disable update table of contents on save
   "markdown.extension.toc.updateOnSave": false,
-  "workbench.editor.enablePreviewFromCodeNavigation": false
-}
+
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll.ruff": true,
+      "source.organizeImports.ruff": true
+    }
+  }
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index e69de29bb..d8ab8a7ba 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,51 @@
+# 🐾 **The Cat Coders** 🐾
+
+## **Welcome to Our Project!** ![Alt Text](assets/hi.gif)
+
+Welcome to **The Cat Coders'** official repository! We're a group of passionate
+learners collaborating on exciting Python programming challenges, dedicated to sharpening
+our Python skills through collaboration and creativity.
+
+---
+
+## ![AltText](assets/cat3.gif) **About Us**
+
+We are **The Cat Coders**, a team of enthusiastic programmers driven by curiosity,
+creativity, and a love for clean, efficient code. Our goal is to learn, grow,
+and build projects that make a difference.
+
+### ![AltText](assets/cat2.gif)**Our Mission:**
+
+- Focus on solving programming challenges, debugging code, and enhancing our
+Python skills through collaborative problem-solving.
+- Learn collaboratively and share knowledge.
+- Review each other's code and getting familiar with Github.
+- Foster an inclusive and supportive team environment.
+
+---
+
+## ![AltText](assets/cat.gif) **Communication**
+
+- **Slack:** For **Daily** updates on our progress.
+- **Weekly Meetings:** Every **Tuesday at 7 PM Egypt Time** on **Zoom**.
+
+---
+
+## ![AltText](assets/cat5.gif) **Team Values**
+
+- **Open Communication:** Share ideas and ask questions freely.
+- **Respect:** Every voice matters.
+- **Accountability:** Own your tasks and support your teammates.
+- **Collaboration:** Work together, learn together, grow together.
+
+---
+
+## ⭐ **Acknowledgments**
+
+Shoutout to every member of **The Cat Coders** for their dedication and hard work.
+Let's keep coding and keep growing—one paw at a time! 🐾✨
+
+---
+
+**Stay curious, stay creative, and keep coding! 🐈‍⬛💻**
+![Alt Text](assets/cat4.gif)
diff --git a/assets/cat.gif b/assets/cat.gif
new file mode 100644
index 000000000..8bc4d62ff
Binary files /dev/null and b/assets/cat.gif differ
diff --git a/assets/cat2.gif b/assets/cat2.gif
new file mode 100644
index 000000000..23da72fae
Binary files /dev/null and b/assets/cat2.gif differ
diff --git a/assets/cat3.gif b/assets/cat3.gif
new file mode 100644
index 000000000..701a260bb
Binary files /dev/null and b/assets/cat3.gif differ
diff --git a/assets/cat4.gif b/assets/cat4.gif
new file mode 100644
index 000000000..322f69595
Binary files /dev/null and b/assets/cat4.gif differ
diff --git a/assets/cat5.gif b/assets/cat5.gif
new file mode 100644
index 000000000..80c75cf1a
Binary files /dev/null and b/assets/cat5.gif differ
diff --git a/assets/hi.gif b/assets/hi.gif
new file mode 100644
index 000000000..b5d902322
Binary files /dev/null and b/assets/hi.gif differ
diff --git a/collaboration/guide/0_repository_setup.md b/collaboration/guide/0_repository_setup.md
index aae9cb76e..a555ef16d 100644
--- a/collaboration/guide/0_repository_setup.md
+++ b/collaboration/guide/0_repository_setup.md
@@ -15,7 +15,8 @@ it for collaboration:
     [repository description](https://stackoverflow.com/questions/7757751/how-do-you-change-a-repository-description-on-github)
   - Add or remove topics from your repository
   - Update your main README with your group name and an initial overview of your
-    project. (You can change this as much as you want.)
+  project. (You can change this as much as you want.)
+
 - Under settings in your repository select:
   - _Issues_
   - _Projects_