chore(lambda-rs): create dedicated crates for demos

Author: vmarcella

.github/ISSUE_TEMPLATE/bug.yml

@@ -43,7 +43,8 @@ body:
       description: Provide minimal steps to reproduce the issue.
       placeholder: |
         1. Clone repository
-        2. Run `cargo run --example <name>`
+        2. Run `cargo run -p lambda-demos-render --bin <name>` (or the relevant
+           `lambda-demos-*` crate)
         3. Observe error/unexpected behavior
     validations:
       required: true

.github/workflows/compile_lambda_rs.yml

@@ -90,13 +90,15 @@ jobs:
 
       - name: Build workspace
         if: ${{ contains(matrix.features, 'lambda-rs/audio-output-device') }}
-        run: cargo build --workspace --features ${{ matrix.features }}
+        run: cargo build --workspace --bins --features ${{ matrix.features }}
 
       - name: Build workspace (exclude audio tools)
         if: ${{ !contains(matrix.features, 'lambda-rs/audio-output-device') }}
         run: |
           cargo build --workspace \
             --exclude lambda-audio-tool \
+            --exclude lambda-demos-audio \
+            --bins \
             --features ${{ matrix.features }}
 
       - name: Build examples (lambda-rs)
@@ -111,6 +113,7 @@ jobs:
         run: |
           cargo test --workspace \
             --exclude lambda-audio-tool \
+            --exclude lambda-demos-audio \
             --features ${{ matrix.features }}
 
       - uses: actions/setup-ruby@v1

.github/workflows/coverage.yml

@@ -67,13 +67,19 @@ jobs:
       - name: Generate full coverage JSON
         run: |
           cargo llvm-cov --workspace \
+            --exclude lambda-demos-audio \
+            --exclude lambda-demos-minimal \
+            --exclude lambda-demos-render \
             --features lambda-rs/with-vulkan,lambda-rs/audio-output-device \
             --json \
             --output-path coverage.json
 
       - name: Generate HTML coverage report
         run: |
           cargo llvm-cov --workspace \
+            --exclude lambda-demos-audio \
+            --exclude lambda-demos-minimal \
+            --exclude lambda-demos-render \
             --features lambda-rs/with-vulkan,lambda-rs/audio-output-device \
             --html \
             --output-dir coverage-html \
@@ -86,7 +92,10 @@ jobs:
           # Use GitHub's provided base/head SHAs for accurate diff
           base_sha="${{ github.event.pull_request.base.sha }}"
           head_sha="${{ github.event.pull_request.head.sha }}"
-          changed_files=$(git diff --name-only "$base_sha" "$head_sha" -- '*.rs' | tr '\n' ' ')
+          changed_files=$(git diff --name-only "$base_sha" "$head_sha" -- \
+            '*.rs' \
+            ':(exclude)demos/**' \
+            | tr '\n' ' ')
           echo "files=$changed_files" >> "$GITHUB_OUTPUT"
 
       - name: Generate coverage report data

.github/workflows/release.yml

@@ -67,6 +67,12 @@ jobs:
             # binaries. Audio/tool validation runs in the CI build matrix when
             # audio features are enabled.
             --exclude lambda-audio-tool \
+            # Demo crates are validated in the CI build matrix (compile & test
+            # workflow). Exclude them here to keep the release workflow focused
+            # on release artifacts.
+            --exclude lambda-demos-audio \
+            --exclude lambda-demos-minimal \
+            --exclude lambda-demos-render \
             --all-targets \
             -- -D warnings
 
@@ -75,6 +81,9 @@ jobs:
           cargo test --workspace \
             # See note above in the Clippy step.
             --exclude lambda-audio-tool \
+            --exclude lambda-demos-audio \
+            --exclude lambda-demos-minimal \
+            --exclude lambda-demos-render \
             -- --nocapture
 
   prepare_version:
@@ -236,7 +245,13 @@ jobs:
           # See note in the validate job: `lambda-audio-tool` is excluded here
           # to avoid Linux ALSA build dependencies that are unnecessary for
           # release artifacts.
-          cargo build --workspace --exclude lambda-audio-tool --release --bins
+          cargo build --workspace \
+            --exclude lambda-audio-tool \
+            --exclude lambda-demos-audio \
+            --exclude lambda-demos-minimal \
+            --exclude lambda-demos-render \
+            --release \
+            --bins
 
       - name: Stage files
         id: stage

.gitignore

@@ -138,8 +138,8 @@ Temporary Items
 
 #!! ERROR: opengl is undefined. Use list command to see defined gitignore types !!#
 
-# Remove bin
-bin
+# Remove root-level bin
+/bin/
 
 # Remove clangd
 .clangd/

Cargo.lock

@@ -9,6 +9,10 @@ members = [
   "crates/lambda-rs-platform",
   "tools/obj_loader",
   "tools/lambda_audio",
+  # Demo crates (not built by default; see `default-members`).
+  "demos/audio",
+  "demos/render",
+  "demos/minimal",
 ]
 
 default-members = [

Cargo.toml

@@ -134,26 +134,27 @@ Start with the tutorials to build features step by step:
 
 ## Examples <a name="examples"></a>
 
-Browse example sources:
+Browse runnable demos and example sources:
 
-* Core API examples: [crates/lambda-rs/examples/](./crates/lambda-rs/examples/)
+* Demo crates (recommended): [demos/](./demos/)
+* Minimal rustdoc examples: [crates/lambda-rs/examples/](./crates/lambda-rs/examples/)
 * Logging examples: [crates/lambda-rs-logging/examples/](./crates/lambda-rs-logging/examples/)
 * Argument parsing examples: [crates/lambda-rs-args/examples/](./crates/lambda-rs-args/examples/)
 
 ### Minimal
 
-A minimal example of an application with a working window using lambda.
+A minimal demo of an application with a working window using lambda.
 
-```rust
-cargo run --example minimal
+```bash
+cargo run -p lambda-demos-minimal --bin minimal
 ```
 
 ### Immediates
 
 An example of using shaders with immediates (per-draw data) to render a 3D image.
 
-```rust
-cargo run --example immediates
+```bash
+cargo run -p lambda-demos-render --bin immediates
 ```
 
 #### Notes
@@ -166,16 +167,16 @@ in either dx11 or dx12.
 
 An example using shaders to render a single triangle.
 
-```rust
-cargo run --example triangle
+```bash
+cargo run -p lambda-demos-render --bin triangle
 ```
 
 ### Triangles
 
 An example using shaders to render multiple triangles and keyboard input to move one of the triangles on screen.
 
-```rust
-cargo run --example triangles
+```bash
+cargo run -p lambda-demos-render --bin triangles
 ```
 
 ## Plans <a name="plans"></a>

README.md

@@ -8,8 +8,9 @@
 //!   event/render loop.
 //! - `math`: minimal vector/matrix utilities used by examples and helpers.
 //!
-//! See runnable examples in `crates/lambda-rs/examples/` and integration tests
-//! under `crates/lambda-rs/tests/` for typical usage patterns.
+//! See runnable demos under `demos/` and the minimal rustdoc reference example
+//! under `crates/lambda-rs/examples/` for typical usage patterns. Integration
+//! tests live under `crates/lambda-rs/tests/`.
 
 pub mod component;
 pub mod events;