Dioxus - Revision history

CathalMullan at 16:22, 12 January 2026

2026-01-12T16:22:45Z

← Older revision		Revision as of 16:22, 12 January 2026
Line 4:		Line 4:

	==== ''wasm-bindgen'' mismatch ====		==== ''wasm-bindgen'' mismatch ====
	'''Note:''' As of Nixpkgs 25.11, the ''wasm-bindgen-cli'' is automatically bundled with the correct version when using ''dioxus-cli'', so the workarounds described below are no longer necessary.		'''Note:''' As of Nixpkgs 25.11, the ''wasm-bindgen-cli'' is automatically bundled with the correct version when using ''dioxus-cli'', so the workarounds described below are no longer necessary.

	A common issue when using the ''dioxus-cli'' version from Nixpkgs is encountering the following error:<syntaxhighlight lang="text">		A common issue when using the ''dioxus-cli'' version from Nixpkgs is encountering the following error:<syntaxhighlight lang="text">

CathalMullan: Mention wasm-bindgen workarounds are no longer needed on newer Nixpkgs

2026-01-12T16:22:29Z

Mention wasm-bindgen workarounds are no longer needed on newer Nixpkgs

← Older revision		Revision as of 16:22, 12 January 2026
Line 4:		Line 4:

	==== ''wasm-bindgen'' mismatch ====		==== ''wasm-bindgen'' mismatch ====
			'''Note:''' As of Nixpkgs 25.11, the ''wasm-bindgen-cli'' is automatically bundled with the correct version when using ''dioxus-cli'', so the workarounds described below are no longer necessary.

	A common issue when using the ''dioxus-cli'' version from Nixpkgs is encountering the following error:<syntaxhighlight lang="text">		A common issue when using the ''dioxus-cli'' version from Nixpkgs is encountering the following error:<syntaxhighlight lang="text">
	it looks like the Rust project used to create this Wasm file was linked against		it looks like the Rust project used to create this Wasm file was linked against

Neutral: Added example flake.nix

2025-09-08T17:47:22Z

Added example flake.nix

@@ Line 75: / Line 75: @@
      hash = pkgs.lib.fakeHash;
    };
-};</syntaxhighlight>
+};</syntaxhighlight>'''Example flake.nix'''<syntaxhighlight lang="nix">
 [[Category:Rust]]

Neutral: wasm-bindgen-cli package uses buildWasmBindgenCli function now.

2025-09-08T17:44:37Z

wasm-bindgen-cli package uses buildWasmBindgenCli function now.

← Older revision		Revision as of 17:44, 8 September 2025
Line 56:		Line 56:

	==== Choosing ''wasm-bindgen-cli'' version ====		==== Choosing ''wasm-bindgen-cli'' version ====
	You will also want to ensure the version of ''wasm-bindgen-cli'' matches whatever is in your lock file.<syntaxhighlight lang="nix">		You will also want to ensure the version of ''wasm-bindgen-cli'' matches whatever is in your lock file.<syntaxhighlight lang="nix">cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);
	cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);

	wasmBindgen = pkgs.lib.findFirst		wasmBindgen = pkgs.lib.findFirst
Line 64:		Line 63:
	cargoLock.package;		cargoLock.package;

	wasm-bindgen-cli = pkgs.wasm-bindgen-cli~~.override {~~		wasm-bindgen-cli = pkgs.buildWasmBindgenCli rec {
	version = wasmBindgen.version;		src = pkgs.fetchCrate {
	hash = pkgs.lib.fakeHash;		pname = "wasm-bindgen-cli";
	~~cargoHash~~ = pkgs.lib.fakeHash;		version = wasmBindgen.version;
	};		hash = pkgs.lib.fakeHash;
	</syntaxhighlight>		};

			cargoDeps = pkgs.rustPlatform.fetchCargoVendor {
			inherit src;
			inherit (src) pname version;
			hash = pkgs.lib.fakeHash;
			};
			};</syntaxhighlight>

	[[Category:Rust]]		[[Category:Rust]]

CathalMullan: Fix page hierarchy.

2025-01-10T14:25:39Z

Fix page hierarchy.

← Older revision		Revision as of 14:25, 10 January 2025
Line 12:		Line 12:
	</syntaxhighlight>		</syntaxhighlight>

	==== Why does this happen? ====		===== Why does this happen? =====
	Unlike most Rust crates, ''wasm-bindgen'' doesn't follow [https://semver.org semantic versioning (SemVer)]. This means even a patch version difference (like 0.2.97 vs 0.2.98) can contain breaking changes or incompatibilities.		Unlike most Rust crates, ''wasm-bindgen'' doesn't follow [https://semver.org semantic versioning (SemVer)]. This means even a patch version difference (like 0.2.97 vs 0.2.98) can contain breaking changes or incompatibilities.

CathalMullan: Document why wasm-bindgen version mismatch occurs

2025-01-10T14:22:43Z

Document why wasm-bindgen version mismatch occurs

← Older revision		Revision as of 14:22, 10 January 2025
Line 10:		Line 10:
	rust Wasm file schema version: 0.2.99		rust Wasm file schema version: 0.2.99
	this binary schema version: 0.2.97		this binary schema version: 0.2.97
	</syntaxhighlight>There are two solutions to solving this:		</syntaxhighlight>

			==== Why does this happen? ====
			Unlike most Rust crates, ''wasm-bindgen'' doesn't follow [https://semver.org semantic versioning (SemVer)]. This means even a patch version difference (like 0.2.97 vs 0.2.98) can contain breaking changes or incompatibilities.

			When you install ''dioxus-cli'' from Nixpkgs, it uses the exact versions of dependencies specified in the packages lock file, just like running <code>cargo install dioxus-cli --locked</code>. The versions present in the packages lock file are chosen '''at publishing time'''.

			When you add ''dioxus'' as a dependency in your project's ''Cargo.toml'' (or any other crate that requires on ''wasm-bindgen''), [https://doc.rust-lang.org/cargo/reference/resolver.html#semver-compatibility Cargo assumes that all dependencies follow SemVer], and pulls in the latest SemVer compatible version of ''wasm-bindgen.'' This will likely be a different version than was present in the ''dioxus-cli'' lock file, since ''wasm-bindgen'' tends to release quite often.

			There are two solutions to solving this:

	# ~~Downgrade~~ ''wasm-bindgen'' to the version that ''dioxus-cli'' expects.		# Pin ''wasm-bindgen'' to the version that ''dioxus-cli'' expects.
	# Update ''dioxus-cli'' to use a newer lock file.		# Update ''dioxus-cli'' to use a newer lock file.

	===== ~~Downgrading~~ ''wasm-bindgen'' =====		===== Pin ''wasm-bindgen'' =====
	Within your ''Cargo.toml'' file, force ''wasm-bindgen'' to use the expected version.<syntaxhighlight lang="toml">		Within your ''Cargo.toml'' file, force ''wasm-bindgen'' to use the expected version by pinning it.<syntaxhighlight lang="toml">
	[dependencies]		[dependencies]
	wasm-bindgen = "=0.2.97"		wasm-bindgen = "=0.2.97"
Line 31:		Line 40:
	e.g. https://crates.io/api/v1/crates/dioxus-cli/0.6.0/download		e.g. https://crates.io/api/v1/crates/dioxus-cli/0.6.0/download

	Extract the file, ''cd'' into the directory, and run ''cargo update''. You should be able to see the ''wasm-bindgen'' version being updated.<syntaxhighlight>		Extract the file, <code>cd</code> into the directory, and run <code>cargo update</code>. You should be able to see the ''wasm-bindgen'' version being updated.<syntaxhighlight>
	Updating wasm-bindgen v0.2.97 -> v0.2.99		Updating wasm-bindgen v0.2.97 -> v0.2.99
	</syntaxhighlight>Copy the newly updated lock file into your project (here called ''Dioxus.lock''), and override the Nixpkgs version.<syntaxhighlight lang="nix">		</syntaxhighlight>Copy the newly updated lock file into your project (here called ''Dioxus.lock''), and override the Nixpkgs version.<syntaxhighlight lang="nix">
Line 46:		Line 55:
	</syntaxhighlight>		</syntaxhighlight>

	==== ''~~Choosing~~ wasm-bindgen-cli ~~version~~'' ====		==== Choosing ''wasm-bindgen-cli'' version ====
	You will also want to ensure the version of ''wasm-bindgen-cli'' matches whatever is in your lock file.<syntaxhighlight lang="nix">		You will also want to ensure the version of ''wasm-bindgen-cli'' matches whatever is in your lock file.<syntaxhighlight lang="nix">
	cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);		cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);

AveryKoen at 22:10, 30 December 2024

2024-12-30T22:10:34Z

← Older revision		Revision as of 22:10, 30 December 2024
Line 1:		Line 1:
	[https://dioxuslabs.com Dioxus] is a full-stack Rust app framework for web, desktop, mobile, and more.		[https://dioxuslabs.com Dioxus] is a full-stack [[Rust]] app framework for web, desktop, mobile, and more.

	=== Troubleshooting ===		=== Troubleshooting ===

Klinger: changed Category:Applications into Category:Rust (Applications is only for end-user applications, not for application developmentr

2024-12-26T19:14:30Z

changed Category:Applications into Category:Rust (Applications is only for end-user applications, not for application developmentr

← Older revision		Revision as of 19:14, 26 December 2024
Line 61:		Line 61:
	};		};
	</syntaxhighlight>		</syntaxhighlight>
	[[Category:~~Applications~~]]
			[[Category:Rust]]

CathalMullan: Phrasing.

2024-12-24T21:03:11Z

Phrasing.

← Older revision		Revision as of 21:03, 24 December 2024
Line 46:		Line 46:
	</syntaxhighlight>		</syntaxhighlight>

	==== ''wasm-bindgen-cli version'' ====		==== ''Choosing wasm-bindgen-cli version'' ====
	You will also want to ensure the version of ''wasm-bindgen-cli'' matches whatever is in your lock file.<syntaxhighlight lang="nix">		You will also want to ensure the version of ''wasm-bindgen-cli'' matches whatever is in your lock file.<syntaxhighlight lang="nix">
	cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);		cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);

CathalMullan: Showcase replacing lock file.

2024-12-24T21:02:35Z

Showcase replacing lock file.

@@ Line 12: / Line 12: @@
 </syntaxhighlight>There are two solutions to solving this:
-# Downgrade ''wasm-bindgen'' to the version the ''dioxus-cli'' expects.
+# Downgrade ''wasm-bindgen'' to the version that ''dioxus-cli'' expects.
 # Update ''dioxus-cli'' to use a newer lock file.
@@ Line 22: / Line 22: @@
 </syntaxhighlight>Run ''cargo update'', and you should see the version being downgraded.<syntaxhighlight lang="text">
 Downgrading wasm-bindgen v0.2.99 -> v0.2.97 (available: v0.2.99)
-</syntaxhighlight>You will also want to ensure the version of ''wasm-bindgen-cli'' matches, which can be done via looking up the current version from the lock file. <syntaxhighlight lang="nix">
+</syntaxhighlight>
 cargoLock = builtins.fromTOML (builtins.readFile ./Cargo.lock);