diff --git a/README.md b/README.md
index d18713a..30dd52b 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,31 @@
-# `functions-js`
+# ⚠️ REPOSITORY DEPRECATED - MOVED TO MONOREPO
+
+> **🚨 This repository has been moved and will be archived on October 10, 2025**
+>
+> **All development has moved to the [Supabase JS Monorepo](https://github.com/supabase/supabase-js)**
+>
+> **If you're looking for the README of `functions-js`, you can find it at:**  
+> **https://github.com/supabase/supabase-js/tree/master/packages/core/functions-js**
+>
+> ### What happened?
+> This repository was merged into the main Supabase JS monorepo for better coordination, testing, and releases.
+>
+> ### What you need to do:
+> - **📖 For documentation**: Visit the [new functions-js location](https://github.com/supabase/supabase-js/tree/master/packages/core/functions-js)
+> - **🐛 For issues**: Create them in the [supabase-js repository](https://github.com/supabase/supabase-js/issues)
+> - **🔧 For contributions**: See the [Contributing Guide](https://github.com/supabase/supabase-js/blob/master/CONTRIBUTING.md)
+> - **📚 For migration help**: Read the [Migration Guide](https://github.com/supabase/supabase-js/blob/master/docs/MIGRATION.md)
+>
+> ### If you have open work:
+> - **Uncommitted changes**: Manually transport your work to the monorepo (file structure is the same under `packages/core/functions-js/`)
+> - **Open PRs**: Tag a maintainer in your PR and we'll help you migrate it
+> - **Issues**: Will be transported to the supabase-js repository
+>
+> **⚠️ This is the old repository. Please use the [supabase-js monorepo](https://github.com/supabase/supabase-js) going forward.**
+
+---
+
+# `functions-js` (DEPRECATED - USE MONOREPO)
 
 [![Coverage Status](https://coveralls.io/repos/github/supabase/functions-js/badge.svg?branch=main)](https://coveralls.io/github/supabase/functions-js?branch=main) [![pkg.pr.new](https://pkg.pr.new/badge/supabase/functions-js)](https://pkg.pr.new/~/supabase/functions-js)