From a6be091bdadcfe132afd2f83b7e0d72154080bb4 Mon Sep 17 00:00:00 2001
From: Brian Smith <112954497+brian-smith-tcril@users.noreply.github.com>
Date: Mon, 5 May 2025 14:55:50 -0400
Subject: [PATCH] docs: warn about design tokens

---
 README.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.rst b/README.rst
index 293567f9..dee54af5 100644
--- a/README.rst
+++ b/README.rst
@@ -3,6 +3,12 @@ frontend-template-application
 
 |license-badge| |status-badge| |ci-badge| |codecov-badge|
 
+⚠️ Warning ⚠️
+***************
+
+This template uses a version of Paragon that includes `design tokens <https://github.com/openedx/paragon/?tab=readme-ov-file#design-tokens>`_ support. Support for design tokens is a breaking change, and more information is available in `the DEPR <https://github.com/openedx/brand-openedx/issues/23>`_.
+
+To use this template with a pre-design-tokens version of Paragon, you can utilize `the release/teak branch <https://github.com/openedx/frontend-template-application/tree/release/teak>`_.
 
 Purpose
 *******