diff --git a/README.md b/README.md
index 62339f5..6bd8b54 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,84 @@
 # Rectangle Fitting
 
-このプログラムは、画像を指定した数の非重複の長方形に隙間なく分割するアルゴリズムを実装しています。目標は、指定された画像をできるだけ正確に再現し、ピクセルのRGB値の平均二乗差を最小限に抑えることです。
+画像を指定した数の非重複の長方形に隙間なく分割するアルゴリズムの実装と、その様子を可視化する Web アプリです。
 
-## 使用方法
+| 元画像                                                             | 貪欲法の可視化アニメーション                                   |
+| ------------------------------------------------------------------ | -------------------------------------------------------------- |
+| <img src="./web/test/images/parrots.png" alt="元画像" width="360"> | <img src="./docs/greedy.gif" alt="貪欲法の可視化" width="360"> |
 
-1. [こちら](https://shimo-1999.github.io/rectangle-fitting/) からデプロイ済みのアプリケーションにアクセスできます。
-2. アプリケーションに画像をアップロードし、分割する長方形の数を指定します。
-3. 実行ボタンを押します。
-   - 画像をアプロードしなかった場合、処理はテスト画像で実行されます。
-4. 処理が完了すると、生成された画像及び gif が確認できます。また、これらはダウンロードできます。
+## 使い方
 
-## テスト画像
+- デモ（GitHub Pages）：**[https://shimo-1999.github.io/rectangle-fitting/](https://shimo-1999.github.io/rectangle-fitting/)**
 
-- 使用しているテスト画像は Kodak image dataset の 23 番の画像です。出典は[こちら](https://r0k.us/graphics/kodak/)
+<p align="center">
+  <img src="./docs/demo-ux.gif" alt="Web アプリ画面" width="480">
+</p>
 
-## アルゴリズムの詳細
+1. 上のデモページにアクセスします。
+2. 左パネルで **画像** を選択し、**長方形の数** を入力します。
+3. **実行** を押します（画像未選択時は `parrots.png` で実行）。
+4. 右パネルで **再生**／**PNG 保存**／**GIF 保存**／**PNG 全保存（ZIP）** が利用できます。
 
-- 貪欲法
-  
-  存在する長方形の分割線を全探索し、最も二乗差が小さくなる分割線を選び分割します。
-  （長方形を生成するタイミングで分割線をあらかじめ調べ、保持しておくことで更なる高速化が期待できます。これは実装予定です。）
+> **注意**
+> 細かい長方形が多い場合、GIF はチラつくことがあります。高品質な動画を共有したい場合は **PNG 全保存 → ffmpeg で MP4 化**がおすすめです。
 
-- 焼きなまし法
+## アルゴリズム開発
 
-  実装予定です。
+アルゴリズムは **Rust（Wasm）** で実装しています。
+
+### 実装インターフェース
+
+以下のような関数を実装すれば、それを可視化できます。
+
+- **引数**：`width: usize`, `height: usize`, `rgb_data: &[u8]`（サイズは `width * height * 3`）
+- **戻り値**：`Vec<Vec<Rect>>`（各ステップの長方形リスト）
+
+```rust
+pub struct Rect {
+    pub x1: u16,
+    pub y1: u16,
+    pub x2: u16,
+    pub y2: u16,
+    pub color: u32, // RGB
+}
+```
+
+- 1 ステップ = 「現在の分割状態を構成する長方形の集合」。
+- `Vec<Vec<Rect>>` の **外側 Vec** が時間（ステップ）を表します。
+
+### 開発の進め方
+
+- Rust 側：`wasm/src/algorithms/` にアルゴリズムを追加。
+- `wasm/src/algorithms/mod.rs` と `wasm/src/lib.rs` の `run_algorithm_with_image` に分岐を追加。
+- `index.html` に選択ボタン追加。
+- Wasm のビルド（ローカル実行しやすい出力先へ）  
+  例：
+
+```bash
+cd wasm
+wasm-pack build --release --target web \
+  --out-dir ../web/wasm/pkg
+cd ..
+
+# ローカルサーバで確認
+python -m http.server
+# → http://localhost:8000/web/ にアクセス
+```
+
+## 出典
+
+- テスト画像：**Kodak image dataset #23**（出典：https://r0k.us/graphics/kodak ）
+
+## 参考資料 / 謝辞
+
+実装と可視化の過程で、以下の記事や作品を大いに参考にしました。感謝いたします。
+
+- **Algo Artis 合宿ブログ**  
+  https://media.algo-artis.com/posts/bN4vP1cR  
+  本リポジトリのアルゴリズム実装・可視化の方針を決める上で最も参考にしました。
+
+- **かれをばな さんのブログ**  
+  https://atarabi.hateblo.jp/entry/2012/03/15/023621
+
+- **Box Fitting — Jared Tarbell**  
+  http://www.complexification.net/gallery/machines/boxFitting
diff --git a/docs/demo-ux.gif b/docs/demo-ux.gif
new file mode 100644
index 0000000..fa2efba
Binary files /dev/null and b/docs/demo-ux.gif differ
diff --git a/docs/greedy.gif b/docs/greedy.gif
new file mode 100644
index 0000000..9ced2b6
Binary files /dev/null and b/docs/greedy.gif differ