diff --git a/.gitignore b/.gitignore
index e09896d..2ef4e35 100644
--- a/.gitignore
+++ b/.gitignore
@@ -159,3 +159,8 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 .idea/
+
+docs/macos/zed
+!docs/macos/zed/keymap.json
+!docs/macos/zed/settings.json
+!docs/macos/zed/themes
\ No newline at end of file
diff --git a/Raycast 2024-11-18 12.27.17.rayconfig b/docs/macos/Raycast 2024-11-18 12.27.17.rayconfig
similarity index 100%
rename from Raycast 2024-11-18 12.27.17.rayconfig
rename to docs/macos/Raycast 2024-11-18 12.27.17.rayconfig
diff --git a/docs/macos/macos b/docs/macos/macos
index 5bbcd19..32f2f18 100644
--- a/docs/macos/macos
+++ b/docs/macos/macos
@@ -6,14 +6,17 @@ feel free to do so :
 
 - install brave browser
 - install sdk tools (it installs git) (i used pycharm since it does it automatically, pycharm activate sync settings)
-- install omz, powerlvl10k ? always install this first, becasue it updates the .zshrc file
-
-- install brew + copy path
-- install
-- install raycast
+- install omz, powerlvl10k ? always install this first, because it updates the .zshrc file
+- (optional) install uv and copy this to zshrc :
 
 - install brew then : echo "export PATH=/opt/homebrew/bin:$PATH" >> ~/.zshrc
-- brew install bat fastfetch btop ....
+- install raycast (import settings if previously installed)
+- brew install iTerm2 (if manual from raycast) . import settings : it includes
+    - iterm2 ( change the font to Jetbrains font, change also the color)
+        - command +t : new tab
+        - command+d :
+        - command + i : settings
+- brew install bat fastfetch btop , lsd....
 ...
     echo 'alias cat="bat"' >>~/.zshrc
   bat is the macos equivalent of ubuntu's batcat
@@ -23,10 +26,9 @@ feel free to do so :
     - you can alias another python if you want echo this : alias python=/usr/bin/python3 in .zshrc (this is the python that comes with macos)
     - alias python="uv run python" in .zshrc
 
-- install new terminal ? iterm2 ( change the font to Jetbrains font, change also the color)
-    - command +t : new tab
-    - command+d :
-    - command + i : settings
+
+
+
  - alttab : alttab as in windows & also, close directly apps from there (if you switch the keys like i did, you will have a similar env as in windows)
 - raycast (powershell alternative) with extensions. it also has a camera preview, brew search, and loooot more
 - extensions to isntall :
diff --git a/docs/macos/zed/keymap.json b/docs/macos/zed/keymap.json
new file mode 100644
index 0000000..78f5c8d
--- /dev/null
+++ b/docs/macos/zed/keymap.json
@@ -0,0 +1,21 @@
+// Zed keymap
+//
+// For information on binding keys, see the Zed
+// documentation: https://zed.dev/docs/key-bindings
+//
+// To see the default key bindings run `zed: open default keymap`
+// from the command palette.
+[
+  {
+    "context": "Workspace",
+    "bindings": {
+      // "shift shift": "file_finder::Toggle"
+    }
+  },
+  {
+    "context": "Editor",
+    "bindings": {
+      // "j k": ["workspace::SendKeystrokes", "escape"]
+    }
+  }
+]
diff --git a/docs/macos/zed/settings.json b/docs/macos/zed/settings.json
new file mode 100644
index 0000000..f19da6d
--- /dev/null
+++ b/docs/macos/zed/settings.json
@@ -0,0 +1,23 @@
+// Zed settings
+//
+// For information on how to configure Zed, see the Zed
+// documentation: https://zed.dev/docs/configuring-zed
+//
+// To see all of Zed's default settings without changing your
+// custom settings, run `zed: open default settings` from the
+// command palette (cmd-shift-p / ctrl-shift-p)
+{
+  "telemetry": {
+    "diagnostics": false,
+    "metrics": false
+  },
+  "ui_font_size": 16,
+  "buffer_font_size": 13,
+  "buffer_font_family": "JetBrainsMono Nerd Font",
+  "base_keymap": "JetBrains",
+  "theme": {
+    "mode": "system",
+    "light": "One Dark - Darkened",
+    "dark": "Night Owl Dark"
+  }
+}