From 975dde3d36ed50dc3719ab91a8b5dbf5e7821f97 Mon Sep 17 00:00:00 2001
From: maxkahan <maxkahan94@gmail.com>
Date: Wed, 14 Oct 2026 15:05:59 +0200
Subject: [PATCH 1/2] docs: add deprecation notice to README

---
 README.md | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 697e7b94..39f03b1c 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,5 @@
-> **Note:** [`stream-sdk-java`](https://github.com/GetStream/stream-sdk-java) is the new full-product SDK for Stream, covering Chat, Video, Moderation, and Feeds with long-term support.
->
-> **`stream-chat-java` is now in maintenance mode.** It will continue to receive critical fixes and requested features, so it is safe to keep using. However, we encourage existing users to migrate when convenient and strongly recommend that new projects start with `stream-sdk-java`.
->
-> Check out the [Migration Guide](https://github.com/GetStream/stream-sdk-java/blob/e58921748ba055e6ec9c8b17a71c599e2256e238/docs/migration-from-stream-chat-java/README.md) for side-by-side examples covering common use cases.
+> [!WARNING]
+> **`stream-chat-java` is deprecated.** New projects should use [`stream-sdk-java`](https://github.com/GetStream/stream-sdk-java) (Maven `io.getstream:stream-sdk-java`), which covers Chat, Video, Moderation and Feeds. To move existing code, see the [migration guide](https://github.com/GetStream/stream-sdk-java/tree/main/docs/migration-from-stream-chat-java).
 
 # Official Java SDK for [Stream Chat](https://getstream.io/chat/docs/)
 

From 1f11609d7f48e6d62fc64b1822e4e386491c26fa Mon Sep 17 00:00:00 2001
From: Max Kahan <max.kahan@getstream.io>
Date: Mon, 19 Oct 2026 15:49:10 +0200
Subject: [PATCH 2/2] docs: make the deprecation notice prominent and mark the
 SDK as legacy

---
 README.md | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 39f03b1c..0d0da2e3 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,18 @@
-> [!WARNING]
-> **`stream-chat-java` is deprecated.** New projects should use [`stream-sdk-java`](https://github.com/GetStream/stream-sdk-java) (Maven `io.getstream:stream-sdk-java`), which covers Chat, Video, Moderation and Feeds. To move existing code, see the [migration guide](https://github.com/GetStream/stream-sdk-java/tree/main/docs/migration-from-stream-chat-java).
+> [!CAUTION]
+> ## ⚠️ This is a legacy SDK. It is deprecated.
+>
+> 🚫 **Do not start new projects with `stream-chat-java`.**
+>
+> ✅ **Use [`stream-sdk-java`](https://github.com/GetStream/stream-sdk-java) (Maven `io.getstream:stream-sdk-java`) instead.** It covers Chat, Video, Moderation and Feeds in one SDK.
+>
+> 🔁 **Already using `stream-chat-java`?** Follow the [migration guide](https://github.com/GetStream/stream-sdk-java/tree/main/docs/migration-from-stream-chat-java) to move your code.
 
-# Official Java SDK for [Stream Chat](https://getstream.io/chat/docs/)
+# Legacy Java SDK for [Stream Chat](https://getstream.io/chat/docs/)
 
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.getstream/stream-chat-java/badge.svg?style=flat)](https://maven-badges.herokuapp.com/maven-central/io.getstream/stream-chat-java) [![build](https://github.com/GetStream/stream-chat-java/workflows/Build/badge.svg)](https://github.com/GetStream/stream-chat-java/actions)
 
 <p align="center">
-    <img src="./assets/logo.svg" width="50%" height="50%">
-</p>
-<p align="center">
-    Official Java API client for Stream Chat, a service for building chat applications.
+    Legacy Java API client for Stream Chat, a service for building chat applications.
     <br />
     <a href="https://getstream.io/chat/docs/"><strong>Explore the docs »</strong></a>
     <br />