diff --git a/.gitignore b/.gitignore
index 394c1bd..186cb54 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,9 @@
 # Local research/extraction scratch
 /.work/
 
+# Checked-in demo script outputs
+/examples/demo-render.png
+
 # Proprietary/local reference payloads. Keep these locally only.
 /reference/
 
diff --git a/Cargo.toml b/Cargo.toml
index 29fb02a..e1a2ea6 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,4 +1,5 @@
 [package]
+default-run = "openvistapro"
 name = "openvistapro"
 version = "0.1.0"
 edition = "2024"
diff --git a/README.md b/README.md
index 83d2b44..72514c0 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,8 @@ cargo run -- render --preset hill --quality final --output /tmp/openvistapro-ren
 cargo run --features app --bin openvistapro_app
 ```
 
+The crate’s default `cargo run` target is the CLI binary (`openvistapro`), so the commands above work without an extra `--bin` flag. Use `--features app --bin openvistapro_app` for the optional GUI shell.
+
 The optional app shell is gated behind the `app` feature so default CLI builds stay GPU-free.
 It opens an `eframe`/`egui` window titled `OpenVistaPro` with scene controls, top-level menus/dialogs, and a CPU-rendered terrain preview.
 The native shell uses eframe's Glow renderer under X11/Xvfb, which keeps the app smoke launch independent of WGPU backend feature selection.