diff --git a/README.md b/README.md
index 803e13a48c..6688fc027a 100644
--- a/README.md
+++ b/README.md
@@ -1,45 +1,33 @@
-
+
+
+
[](https://github.com/deepnote/vscode-deepnote/actions/workflows/ci.yml)
[](https://codecov.io/gh/deepnote/vscode-deepnote)
-[](https://opensource.org/licenses/MIT)
[](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote)
-A powerful [Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote), [Cursor](https://open-vsx.org/extension/Deepnote/vscode-deepnote) and [Windsurf](https://open-vsx.org/extension/Deepnote/vscode-deepnote) extension that brings [Deepnote](https://deepnote.com/) notebook capabilities directly into your favorite editor. Work with sleek AI notebooks featuring SQL blocks, database integrations, and reactive blocks - all within VS Code.
-
----
-
-
+[Website](https://deepnote.com/?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main) • [Docs](https://deepnote.com/docs?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main) • [Changelog](https://deepnote.com/changelog?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main) • [X](https://x.com/DeepnoteHQ) • [Examples](https://deepnote.com/explore?utm_source=github&utm_medium=github&utm_campaign=github&utm_content=readme_main) • [Community](https://github.com/deepnote/deepnote/discussions)
----
-
-# 🚀 Deepnote in VS Code, Cursor and Windsurf - data notebook for AI era
+
-Run Deepnote locally inside VS Code, Cursor and Windsurf — not Jupyter — and unlock the next generation of data workflows:
+# Deepnote in VS Code, Cursor and Windsurf
-- 🧠 **SQL in VS Code** — Run SQL queries out of the box, no extensions needed
-- 🧩 **Rich block types** — Combine Python, Markdown, data visualizations, tables, and more — all in one place
-- 🔐 **Native database connections** — Securely connect to Snowflake, BigQuery, Postgres, and 60+ other sources via VS Code’s encrypted SecretStorage API
-- ⚙️ **Init notebooks** — Auto-run setup code (dependencies, env setup) before execution
-- 📦 **Smart requirements** — Generate `requirements.txt` automatically for reproducible runs
+A powerful [Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote), [Cursor](https://open-vsx.org/extension/Deepnote/vscode-deepnote) and [Windsurf](https://open-vsx.org/extension/Deepnote/vscode-deepnote) extension that brings [Deepnote](https://deepnote.com/) notebook capabilities directly into your favorite editor. Work with sleek AI notebooks featuring SQL blocks, database integrations, and reactive blocks - all within VS Code.
-🐍 **Jupyter kernel, upgraded**
+
-- ⚡ **Deepnote kernel** — Fully `.ipynb-compatible`, tuned for modern data workflows
-- 🔁 **Kernel control** — Restart, interrupt, and switch seamlessly
-🌐 **Deepnote ecosystem integrations**
+Run Deepnote locally inside your IDE and unlock the next generation of data workflows:
-- 🔃 **Auto-refresh** — Instantly detects file and data changes
-- 🧮 **Multi-notebook support** — Work across multiple notebooks in one unified project
-- ☁ **Cloud collaboration** — Switch between local VS Code and Deepnote Cloud to collaborate live on the same file with your team
+- **Rich block types:** Combine Python, Markdown, data visualizations, tables, and more — all in one place
+- **SQL blocks:** Run SQL queries out of the box, no extensions needed
+- **Native database connections:** Securely connect to Snowflake, BigQuery, Postgres, and 60+ other sources via VS Code’s encrypted SecretStorage API
+- **Init notebooks:** Auto-run setup code (dependencies, env setup) before execution
+- **Smart requirements:** Generate `requirements.txt` automatically for reproducible runs
+- **Deepnote kernel:** Fully `.ipynb` compatible, tuned for modern data workflows
+- **Cloud collaboration:** Switch between local VS Code and Deepnote Cloud to collaborate live on the same file with your team
-## 📋 Requirements
-
-- **Visual Studio Code** 1.95.0 or higher
-- **Python** 3.10 or higher (for running notebooks)
-
-## 🎯 Getting started
+## Getting started
1. Open the extensions tab and Search for Deepnote
2. Or alternatively, press `Cmd+P` or `Ctrl+P` to open the command palette.
@@ -48,6 +36,11 @@ Run Deepnote locally inside VS Code, Cursor and Windsurf — not Jupyter — and
Or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Deepnote.vscode-deepnote)
+### Requirements
+
+- **Visual Studio Code** 1.95.0 or higher
+- **Python** 3.10 or higher (for running notebooks)
+
### Opening your first Deepnote notebook
1. Open a folder containing `.deepnote` project files
@@ -56,7 +49,7 @@ Or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/i
4. Select a Python kernel when prompted
5. Start coding!
-## 📖 Usage
+## Usage
### Command palette
@@ -96,36 +89,22 @@ SELECT * FROM users WHERE created_at > '2024-01-01'
Results are displayed as interactive tables that you can explore and export.
-## 🛠️ Quick start for developers
-
-Want to contribute? Check out our [Contributing Guide](CONTRIBUTING.md) for detailed setup instructions.
-
-- Setting up your development environment
-- Running tests
-- Building the extension
-- Submitting pull requests
-
-## 📚 Documentation
-
-- **[Architecture](architecture.md)** - Technical architecture and design decisions
-- **[Deepnote Kernel Implementation](DEEPNOTE_KERNEL_IMPLEMENTATION.md)** - Details on the custom Jupyter kernel
-- **[Integrations & Credentials](INTEGRATIONS_CREDENTIALS.md)** - How database integrations work
-- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute to the project
-
-## 📄 License
+## Need help?
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+- Join our [Community](https://github.com/deepnote/deepnote/discussions)!
+- Open an [Issue](https://github.com/deepnote/vscode-deepnote/issues) for bug reports or feature requests
+- Have a look at [Architecture](architecture.md) for technical and design decisions
+- Visit [Deepnote kernel implementation](DEEPNOTE_KERNEL_IMPLEMENTATION.md) for the custom Jupyter kernel
+- Learn how database integrations work in [Integrations & credentials](INTEGRATIONS_CREDENTIALS.md)
-## 🐛 Issues & support
+## Contributing
-- **Bug reports**: [GitHub issues](https://github.com/deepnote/vscode-deepnote/issues)
-- **Feature requests**: [GitHub discussions](https://github.com/deepnote/deepnote/discussions)
-- **Questions**: [GitHub discussions](https://github.com/deepnote/deepnote/discussions)
+Want to contribute? Check out our [Contributing guide](CONTRIBUTING.md) for detailed setup instructions.
---
-**Built with 💙 by the Deepnote team**
+Built with 💙
diff --git a/assets/deepnote-cover-image.png b/assets/deepnote-cover-image.png
new file mode 100644
index 0000000000..1ee4519837
Binary files /dev/null and b/assets/deepnote-cover-image.png differ
diff --git a/images/deepnote-projects.png b/assets/deepnote-projects.png
similarity index 100%
rename from images/deepnote-projects.png
rename to assets/deepnote-projects.png