diff --git a/CHANGELOG.md b/CHANGELOG.md
index 52560a6..c36d116 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,11 @@ All notable changes to the "codely-theme" extension will be documented in this f
 
 Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
 
+## [1.0.0] - 2026-01-28
+
+- docs: improve theme compatibility documentation and linking
+- chore!: bump minimum supported VS Code version to 1.60 (September 2021) for consistent theming
+
 ## [0.0.1] - 2020-03-04
 
 - Initial release
diff --git a/README.md b/README.md
index a4a91a6..6dc6fda 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,32 @@
-<h1 align="center">🎨 Codely Visual Studio Code Theme</h1>
+<h1 align="center">
+  <🎨> Codely Theme for VS Code
+</h1>
 <p align="center">
-<img src="preview-python.png" alt="Codely VsCode Theme">
-<small><b>Happy Hacking!</b></small><br>
-A modern, good-looking, productivity-increaser theme for <b>Visual Studio Code</b>
-</p>
\ No newline at end of file
+    <a href="https://github.com/CodelyTV"><img src="https://img.shields.io/badge/Codely-OS-green.svg?style=flat-square" alt="Codely Open Source projects"/></a>
+    <a href="https://codely.com/cursos"><img src="https://img.shields.io/badge/Codely-Pro-black.svg?style=flat-square" alt="Codely Pro courses"/></a>
+</p>
+<p align="center">
+    <img src="images/preview-python.png" alt="Codely Theme preview" />
+    A modern, good-looking, productivity-increaser theme for Visual Studio and compatible IDEs.<br><br>
+    <a href="https://github.com/CodelyTV/vscode-theme/stargazers">Stars are welcome 😊</a>
+</p>
+
+## 🤝 Compatible editors
+
+- Visual Studio Code
+- Cursor
+- VSCodium
+- GitHub Codespaces
+- CodeSandbox
+- StackBlitz
+- Any other editor supporting VS Code themes
+
+## 🔗 Related links
+
+- [VS Marketplace theme](https://marketplace.visualstudio.com/items?itemName=codely.codely-theme)
+- [Codely Theme for JetBrains IDEs](https://github.com/CodelyTV/jetbrains-theme)
+
+<p align="right">
+  <small>Happy hacking!</small><br>
+  <sub>🐢 💨 (Turbotuga™, <a href="https://codely.com">Codely</a>’s mascot).</sub>
+</p>
diff --git a/images/icon.png b/images/icon.png
index cdf05b4..2c29c3c 100644
Binary files a/images/icon.png and b/images/icon.png differ
diff --git a/preview-python.png b/images/preview-python.png
similarity index 100%
rename from preview-python.png
rename to images/preview-python.png
diff --git a/package.json b/package.json
index 0e259b0..4eb2bd1 100644
--- a/package.json
+++ b/package.json
@@ -1,41 +1,44 @@
 {
-    "name": "codely-theme",
-    "displayName": "Codely Theme",
-    "description": "A modern, good-looking, productivity-increaser theme for Visual Studio Code",
-    "version": "0.0.1",
-    "scripts": {
-        "build": "vsce package"
-    },
-    "publisher": "Codely",
-    "icon": "images/icon.png",
-    "engines": {
-        "vscode": "^1.51.0"
-    },
-    "categories": [
-        "Themes"
-    ],
-    "keywords": ["dark"],
-    "contributors": [
-        {
-            "email": "royjuni3431@gmail.com",
-            "name": "Royer Guerero",
-            "url": "https://github.com/royerguerrero"
-        }
-    ],
-    "contributes": {
-        "themes": [
-            {
-                "label": "Codely Dark",
-                "uiTheme": "vs-dark",
-                "path": "./themes/dark.codely-theme-color-theme.json"
-            }
-        ]
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/CodelyTV/vscode-theme.git"
-    },
-    "devDependencies": {
-        "vsce": "^1.85.1"
+  "name": "codely-theme",
+  "displayName": "Codely Theme",
+  "description": "A modern, good-looking, productivity-increaser theme for Visual Studio and compatible IDEs.",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "vsce package"
+  },
+  "publisher": "Codely",
+  "icon": "images/icon.png",
+  "engines": {
+    "vscode": "^1.60.0"
+  },
+  "categories": [
+    "Themes"
+  ],
+  "keywords": [
+    "dark",
+    "codely"
+  ],
+  "contributors": [
+    {
+      "email": "royjuni3431@gmail.com",
+      "name": "Royer Guerero",
+      "url": "https://github.com/royerguerrero"
     }
+  ],
+  "contributes": {
+    "themes": [
+      {
+        "label": "Codely Dark",
+        "uiTheme": "vs-dark",
+        "path": "./themes/dark.codely-theme-color-theme.json"
+      }
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CodelyTV/vscode-theme.git"
+  },
+  "devDependencies": {
+    "vsce": "^1.108.2"
+  }
 }