diff --git a/.cargo/config.toml b/.cargo/config.toml
new file mode 100644
index 0000000..e2ec9e5
--- /dev/null
+++ b/.cargo/config.toml
@@ -0,0 +1,5 @@
+[alias]
+run_wasm = "run --release --package run_wasm --"
+# Other crates use the alias run-wasm, even though crate names should use `_`s not `-`s
+# Allow this to be used
+run-wasm = "run_wasm"
diff --git a/.github/copyright.sh b/.github/copyright.sh
new file mode 100755
index 0000000..4b23734
--- /dev/null
+++ b/.github/copyright.sh
@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# If there are new files with headers that can't match the conditions here,
+# then the files can be ignored by an additional glob argument via the -g flag.
+# For example:
+# -g "!src/special_file.rs"
+# -g "!src/special_directory"
+
+# Check all the standard Rust source files
+output=$(rg "^// Copyright (19|20)[\d]{2} (.+ and )?the Velato Authors( and .+)?$\n^// SPDX-License-Identifier: Apache-2\.0 OR MIT$\n\n" --files-without-match --multiline -g "*.rs" .)
+
+if [ -n "$output" ]; then
+ echo -e "The following files lack the correct copyright header:\n"
+ echo $output
+ echo -e "\n\nPlease add the following header:\n"
+ echo "// Copyright $(date +%Y) the Velato Authors"
+ echo "// SPDX-License-Identifier: Apache-2.0 OR MIT"
+ echo -e "\n... rest of the file ...\n"
+ exit 1
+fi
+
+echo "All files have correct copyright headers."
+exit 0
+
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..9944079
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,171 @@
+env:
+ # We aim to always test with the latest stable Rust toolchain, however we pin to a specific
+ # version like 1.70. Note that we only specify MAJOR.MINOR and not PATCH so that bugfixes still
+ # come automatically. If the version specified here is no longer the latest stable version,
+ # then please feel free to submit a PR that adjusts it along with the potential clippy fixes.
+ RUST_STABLE_VER: "1.76" # In quotes because otherwise (e.g.) 1.70 would be interpreted as 1.7
+
+
+# Rationale
+#
+# We don't run clippy with --all-targets because then even --lib and --bins are compiled with
+# dev dependencies enabled, which does not match how they would be compiled by users.
+# A dev dependency might enable a feature of a regular dependency that we need, but testing
+# with --all-targets would not catch that. Thus we split --lib & --bins into a separate step.
+
+name: CI
+
+on:
+ pull_request:
+ merge_group:
+
+jobs:
+ rustfmt:
+ runs-on: ubuntu-latest
+ name: cargo fmt
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: install stable toolchain
+ uses: dtolnay/rust-toolchain@master
+ with:
+ toolchain: ${{ env.RUST_STABLE_VER }}
+ components: rustfmt
+
+ - name: cargo fmt
+ run: cargo fmt --all --check
+
+ - name: install ripgrep
+ run: |
+ sudo apt update
+ sudo apt install ripgrep
+
+ - name: check copyright headers
+ run: bash .github/copyright.sh
+
+ test-stable:
+ runs-on: ${{ matrix.os }}
+ strategy:
+ matrix:
+ # We use macos-14 as that is an arm runner. These have the virtgpu support we need
+ os: [windows-latest, macos-14, ubuntu-latest]
+ include:
+ - os: ubuntu-latest
+ gpu: 'yes'
+ - os: macos-14
+ gpu: 'yes'
+ - os: windows-latest
+ # TODO: The windows runners theoretically have CPU fallback for GPUs, but
+ # this failed in initial testing
+ gpu: 'no'
+ name: cargo clippy + test
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: install stable toolchain
+ uses: dtolnay/rust-toolchain@master
+ with:
+ toolchain: ${{ env.RUST_STABLE_VER }}
+ components: clippy
+
+ - name: restore cache
+ uses: Swatinem/rust-cache@v2
+
+ - name: Install native dependencies
+ if: matrix.os == 'ubuntu-latest'
+ run: sudo apt-get update; sudo apt-get install --no-install-recommends libasound2-dev libudev-dev
+
+ # Adapted from https://github.com/bevyengine/bevy/blob/b446374392adc70aceb92621b080d1a6cf7a7392/.github/workflows/validation-jobs.yml#L74-L79
+ - name: install xvfb, llvmpipe and lavapipe
+ if: matrix.os == 'ubuntu-latest'
+ # https://launchpad.net/~kisak/+archive/ubuntu/turtle
+ run: |
+ sudo apt-get update -y -qq
+ sudo add-apt-repository ppa:kisak/turtle -y
+ sudo apt-get update
+ sudo apt install -y xvfb libegl1-mesa libgl1-mesa-dri libxcb-xfixes0-dev mesa-vulkan-drivers
+
+ - name: cargo clippy (no default features)
+ run: cargo clippy --workspace --lib --bins --no-default-features -- -D warnings
+
+ - name: cargo clippy (no default features) (auxiliary)
+ run: cargo clippy --workspace --tests --benches --examples --no-default-features -- -D warnings
+
+ - name: cargo clippy (default features)
+ run: cargo clippy --workspace --lib --bins -- -D warnings
+
+ - name: cargo clippy (default features) (auxiliary)
+ run: cargo clippy --workspace --tests --benches --examples -- -D warnings
+
+ - name: cargo clippy (all features)
+ run: cargo clippy --workspace --lib --bins --all-features -- -D warnings
+
+ - name: cargo clippy (all features) (auxiliary)
+ run: cargo clippy --workspace --tests --benches --examples --all-features -- -D warnings
+
+ - name: cargo test
+ run: cargo test --workspace --all-features
+ env:
+ VELLO_CI_GPU_SUPPORT: ${{ matrix.gpu }}
+
+ clippy-stable-wasm:
+ runs-on: ubuntu-latest
+ name: cargo test (wasm32)
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: restore cache
+ uses: Swatinem/rust-cache@v2
+
+ - name: install stable toolchain
+ uses: dtolnay/rust-toolchain@master
+ with:
+ toolchain: ${{ env.RUST_STABLE_VER }}
+ targets: wasm32-unknown-unknown
+ components: clippy
+
+ - name: cargo clippy (wasm)
+ run: cargo clippy --all-targets --target wasm32-unknown-unknown --workspace -- -D warnings
+
+ android-stable-check:
+ runs-on: ubuntu-latest
+ name: cargo check (aarch64-android)
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: restore cache
+ uses: Swatinem/rust-cache@v2
+
+ - name: install stable toolchain
+ uses: dtolnay/rust-toolchain@master
+ with:
+ toolchain: ${{ env.RUST_STABLE_VER }}
+ targets: aarch64-linux-android
+
+ - name: install cargo apk
+ run: cargo install cargo-apk
+
+ - name: cargo apk check (android)
+ run: cargo apk check -p with_winit --lib
+ env:
+ # This is a bit of a hack, but cargo apk doesn't seem to allow customising this
+ RUSTFLAGS: '-D warnings'
+
+ docs:
+ name: cargo doc
+ runs-on: ${{ matrix.os }}
+ strategy:
+ matrix:
+ os: [windows-latest, macos-latest, ubuntu-latest]
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: install nightly toolchain
+ uses: dtolnay/rust-toolchain@nightly
+
+ - name: restore cache
+ uses: Swatinem/rust-cache@v2
+
+ # We test documentation using nightly to match docs.rs. This prevents potential breakages
+ - name: cargo doc
+ run: cargo doc --workspace --all-features --no-deps --document-private-items -Zunstable-options -Zrustdoc-scrape-examples
diff --git a/.github/workflows/pages-release.yml b/.github/workflows/pages-release.yml
new file mode 100644
index 0000000..6562ef9
--- /dev/null
+++ b/.github/workflows/pages-release.yml
@@ -0,0 +1,68 @@
+name: Web Demo Update
+
+on:
+ push:
+ branches:
+ - main
+
+jobs:
+ release-web:
+ permissions:
+ contents: read
+ pages: write
+ id-token: write
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Install | Rust
+ uses: dtolnay/rust-toolchain@stable
+ with:
+ targets: wasm32-unknown-unknown
+
+ - name: Install | WASM Bindgen
+ uses: jetli/wasm-bindgen-action@v0.2.0
+ with:
+ version: 'latest'
+
+ - name: Build | WASM
+ run: cargo build -p with_winit --bin with_winit_bin --release --target wasm32-unknown-unknown
+
+ - name: Package | WASM
+ run: |
+ mkdir public
+ wasm-bindgen --target web --out-dir public target/wasm32-unknown-unknown/release/with_winit_bin.wasm --no-typescript
+ cat << EOF > public/index.html
+
+ Velato Web Demo
+
+
+
+
+
+
+
+
+
+