From 12de69fc2d5f95d43bfc6239ec1bb20277acbb7c Mon Sep 17 00:00:00 2001
From: afiqzudinhadi <afiqzudinhadi@gmail.com>
Date: Wed, 24 Jun 2026 16:43:35 +0800
Subject: [PATCH] Add recommendations for 1MB flash boards

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

diff --git a/README.md b/README.md
index aa300e3..cf7d194 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,14 @@ Total flash usage (firmware + engine + dict) on a corne split (central half):
 | Lapwing only | 2.08 MB |
 | No dict (engine only) | 534 KB |
 
+## Making It Work on 1MB Flash
+
+If you want to use this on boards with limited flash (nice_nano_v2, etc.), some options:
+
+- **Optimize dictionary format** — Javelin uses JSC4 hash maps (~2-3MB compiled). A trie/DAWG-based format could reduce this significantly.
+- **Reduce dictionary size** — Trim to most common entries. ~120K entries fits ~458KB, ~100K entries fits ~384KB.
+- **Add external QSPI flash** — Boards with external flash (W25Q128, etc.) can store the full dictionary. The engine already supports XIP reads via `XipPointer`.
+
 ## Setup
 
 Add to your `west.yml`: