diff --git a/cofhejs/examples/end-to-end.mdx b/cofhejs/examples/end-to-end.mdx
index 98401ae..7e57050 100644
--- a/cofhejs/examples/end-to-end.mdx
+++ b/cofhejs/examples/end-to-end.mdx
@@ -2,6 +2,10 @@
title: End-to-End Example
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/examples/end-to-end) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
This example demonstrates a full interaction between a dApp and an FHE-enabled smart contract using `cofhejs`. You'll learn how to set up the client, encrypt data, send it to the contract, create a permit for accessing sealed data, and finally unseal the returned data for the user.
### Prerequisites
diff --git a/cofhejs/guides/encryption.mdx b/cofhejs/guides/encryption.mdx
index 2b8587d..af6aeb5 100644
--- a/cofhejs/guides/encryption.mdx
+++ b/cofhejs/guides/encryption.mdx
@@ -3,6 +3,10 @@ title: Encryption
description: "Encrypt input data before sending it to FHE-enabled smart contracts"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/guides/encrypting-inputs) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
## Encrypting Input Data
This step secures your data before sending it to the smart contract. Remember - all data sent to a smart contract on a blockchain is inherently public, which means that anyone can see it. However, Fhenix operates differently. To maintain user confidentiality and protect sensitive input data, Fhenix utilizes **Cofhejs** to provide built-in encryption methods that you must apply before sending any data to an FHE-enabled contract.
diff --git a/cofhejs/guides/error-handling.mdx b/cofhejs/guides/error-handling.mdx
index b3fcd7c..615839f 100644
--- a/cofhejs/guides/error-handling.mdx
+++ b/cofhejs/guides/error-handling.mdx
@@ -3,6 +3,10 @@ title: Error Handling
description: "Handle errors effectively when working with Cofhejs using the Result type pattern"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/guides/error-handling) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
## Error Handling
`cofhejs` uses a consistent error handling pattern based on the `Result` type to provide predictable and type-safe error handling throughout the library. This guide explains how error handling works and how to properly handle errors in your applications.
diff --git a/cofhejs/guides/permits-management.mdx b/cofhejs/guides/permits-management.mdx
index e0895b5..0b7860f 100644
--- a/cofhejs/guides/permits-management.mdx
+++ b/cofhejs/guides/permits-management.mdx
@@ -3,6 +3,10 @@ title: Permits Management
description: "Create and manage permits for accessing encrypted data in FHE-enabled smart contracts"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/guides/permits) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
## Creating Permits
After encryption, values can be passed into FHE-enabled smart contracts, and the contract can operate on this data securely, within its own logic. However, to ensure that only the respective user can view the processed (encrypted) data, **permissions** and **sealing** mechanisms are used. These ensure that data remains private and viewable exclusively by the user who owns it.
diff --git a/cofhejs/guides/sealing-unsealing.mdx b/cofhejs/guides/sealing-unsealing.mdx
index 52c8175..be93d2e 100644
--- a/cofhejs/guides/sealing-unsealing.mdx
+++ b/cofhejs/guides/sealing-unsealing.mdx
@@ -3,6 +3,10 @@ title: Sealing & Unsealing
description: "Unseal encrypted data returned from FHE-enabled smart contracts"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/guides/decrypt-to-view) instead — sealing/unsealing is handled internally by `decryptForView` / `decryptForTx`. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
## Overview
In Fhenix's FHE system, data returned from smart contracts is "sealed" (internally re-encrypted since it already exists in an encrypted state) to maintain confidentiality during transmission. The unsealing process converts this encrypted data back into readable values using your permit's sealing key pair.
diff --git a/cofhejs/introduction/installation.mdx b/cofhejs/introduction/installation.mdx
index 7badfd7..280e591 100644
--- a/cofhejs/introduction/installation.mdx
+++ b/cofhejs/introduction/installation.mdx
@@ -3,6 +3,10 @@ title: Manual Installation
description: "Install and set up Cofhejs for FHE-enabled smart contract development"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/introduction/installation) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
To get started with Cofhejs, you need to install it as a dependency in your JavaScript project. You can do this using npm (Node Package Manager), Yarn, or pnpm. Open your terminal and navigate to your project's directory, then run the following:
diff --git a/cofhejs/introduction/mental-model.mdx b/cofhejs/introduction/mental-model.mdx
index 7bdf4f0..4685b10 100644
--- a/cofhejs/introduction/mental-model.mdx
+++ b/cofhejs/introduction/mental-model.mdx
@@ -3,6 +3,10 @@ title: Mental Model
description: "Understand how data flows through FHE-enabled dApps"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/introduction/mental-model) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
+
To understand how **Cofhejs** fits into the Fhenix framework, you'll explore a simple mental model using a Counter smart contract example. This will show you how data flows through FHE-enabled dApps—from encryption to computation to decryption.
## The Counter Example
diff --git a/cofhejs/introduction/overview.mdx b/cofhejs/introduction/overview.mdx
index 06b9f91..3997b94 100644
--- a/cofhejs/introduction/overview.mdx
+++ b/cofhejs/introduction/overview.mdx
@@ -3,6 +3,9 @@ title: Overview
description: "Introduction to Cofhejs - a TypeScript package for interacting with FHE-enabled smart contracts"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/introduction/overview) instead. See [Migrating from cofhejs](/client-sdk/introduction/migrating-from-cofhejs) for a side-by-side guide. These pages remain for reference for projects that haven't migrated yet.
+
Cofhejs is a TypeScript package designed to enable seamless interaction between clients and Fhenix's co-processor (CoFHE). It is an essential component for engineers working with FHE-enabled smart contracts, as it facilitates the encryption and decryption processes required for secure data handling in decentralized applications (dApps). Cofhejs ensures that data remains private throughout its journey from input to output in the blockchain ecosystem.
diff --git a/cofhejs/resources/templates.mdx b/cofhejs/resources/templates.mdx
index b3fae14..4df98b9 100644
--- a/cofhejs/resources/templates.mdx
+++ b/cofhejs/resources/templates.mdx
@@ -3,6 +3,10 @@ title: "Development Templates"
description: "Ready-to-use templates, tools, and tutorials to accelerate your FHE-enabled dApp development with Cofhejs"
---
+
+**`cofhejs` is the legacy client library.** New projects should use [`@cofhe/sdk`](/client-sdk/examples/templates) instead — see the templates page on the Client SDK tab for the current starter repos. These pages remain for reference for projects that haven't migrated yet.
+
+
## GitHub Templates
Production-ready code repositories that you can clone and deploy immediately to start building FHE-enabled dApps.