diff --git a/crates/sylpheed-viewer/index.html b/crates/sylpheed-viewer/index.html
index d67d87ab..e1559e3f 100644
--- a/crates/sylpheed-viewer/index.html
+++ b/crates/sylpheed-viewer/index.html
@@ -186,7 +186,7 @@
     </div>
 
     <!-- Trunk injects the compiled WASM module here -->
-    <link data-trunk rel="rust" data-wasm-opt="z" />
+    <link data-trunk rel="rust" data-bin="sylpheed-viewer" data-wasm-opt="z" />
 
     <script>
         // Update loading status messages as WASM initializes
diff --git a/crates/sylpheed-viewer/src/lib.rs b/crates/sylpheed-viewer/src/lib.rs
index 48607390..0e2565ad 100644
--- a/crates/sylpheed-viewer/src/lib.rs
+++ b/crates/sylpheed-viewer/src/lib.rs
@@ -4,7 +4,11 @@
 //!
 //! This crate serves as both:
 //! - A **native binary** (via `main.rs`) — full desktop viewer
-//! - A **WASM library** (this file) — browser viewer at `index.html`
+//! - A **WASM app**, also entered through `main.rs` — browser viewer at
+//!   `index.html`. Trunk builds the *bin* target (`data-bin` in index.html) and
+//!   wasm-bindgen calls `main()`; there is no `#[wasm_bindgen(start)]` here and
+//!   this file is NOT the wasm entry point. Selecting the lib target instead
+//!   links an empty 1.4 KB module that still exits 0 — see #11.
 //!
 //! ## Architecture
 //! - `sylpheed_formats` handles all binary parsing — no Bevy dependency
@@ -42,7 +46,7 @@ impl Default for ViewerState {
 
 /// Build and run the viewer application.
 ///
-/// Called from `main.rs` on native and from `wasm_bindgen` init on the web.
+/// Called from `main.rs`, on both native and wasm.
 pub fn run() {
     let mut app = App::new();