From 126a613527de36942aa9ff3d16be8722c20d0a98 Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Thu, 23 Jul 2026 21:32:59 -0400
Subject: [PATCH] docs: link BitUnlock permission layer plan

---
 docs/README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/README.md b/docs/README.md
index d854ff06..eccd934b 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -4,6 +4,7 @@ Welcome to the bitvid documentation. This directory contains detailed architectu
 
 ## Core Systems
 
+- **[BitUnlock Permission Layer](./BITUNLOCK_PERMISSION_LAYER_PLAN.md)**: Architecture and phased plan for purchases, rentals, creator memberships, platform subscriptions, bundles, events, and short-lived playback authorization using BitUnlock as BitVid's permission layer.
 - **[Application Coordinators](./app-coordinators.md)**: Overview of the coordinator pattern used to manage app-wide state and services.
 - **[Data-Flow Refactor — Dev Plan & Spec](./architecture-refactor.md)**: The incremental plan to put all subsystems on a shared, governed relay/data foundation (SubscriptionManager, stores, unidirectional flow).
 - **[Known Bugs (deferred)](./KNOWN_BUGS.md)**: Confirmed defects/limitations found during the refactor, queued to fix later.
@@ -36,4 +37,8 @@ Welcome to the bitvid documentation. This directory contains detailed architectu
 - **[Deployment Notes](./deployment-notes.md)**: Notes and checklists for deploying bitvid.
 - **[Manual QA Checklist](./qa.md)**: The standard manual QA script for releases.
 
+## Active plans
+
+- **[BitUnlock Permission-Layer TODO](../todo/TODO_2026-07-23_bitunlock-permission-layer.md)**: Ordered implementation checklist for the BitUnlock-backed media permission and subscription work.
+
 For more details on contributing, please see [CONTRIBUTING.md](../CONTRIBUTING.md).