From cc6094f35a3f4d35e754484eed75036f8296497e Mon Sep 17 00:00:00 2001
From: multipleof4 <planetrenox@protonmail.com>
Date: Fri, 20 Mar 2026 22:57:57 -0700
Subject: [PATCH] Docs: Add modular architecture notes

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 5689eeb..0e2711c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,18 @@
 # vibegif.lol
 AI Generated Gifs (BYOK OpenRouter)
+
+## Modular structure
+
+- `index.html` → UI markup only
+- `src/main.js` → app orchestration
+- `src/app/dom.js` → DOM/UI helpers
+- `src/core/storage.js` → API key persistence
+- `src/core/messages.js` → prompt builders
+- `src/services/openrouter.js` → OpenRouter API client
+- `src/services/gif.js` → GIF assembly logic
+- `src/styles.css` → shared styles
+
+## Why no `vite-plugin-html-inject`?
+
+Not required for this refactor.  
+We reduced complexity by extracting logic into JS modules, keeping dependencies minimal and behavior unchanged.