feat: deep linking for hosted URLs and openconcho:// scheme

packages/desktop/src-tauri/Cargo.toml

@@ -14,5 +14,6 @@ tauri-build = { version = "2", features = [] }
 tauri = { version = "2", features = [] }
 tauri-plugin-http = "2"
 tauri-plugin-shell = "2"
+tauri-plugin-deep-link = "2"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"

packages/desktop/src-tauri/capabilities/default.json

@@ -1,19 +1,20 @@
 {
-  "$schema": "../gen/schemas/desktop-schema.json",
-  "identifier": "default",
-  "description": "Default capabilities for the OpenConcho desktop window",
-  "windows": ["main"],
-  "permissions": [
-    "core:default",
-    {
-      "identifier": "http:default",
-      "allow": [
-        { "url": "http://*" },
-        { "url": "http://*:*" },
-        { "url": "https://*" },
-        { "url": "https://*:*" }
-      ]
-    },
-    "shell:allow-open"
-  ]
+	"$schema": "../gen/schemas/desktop-schema.json",
+	"identifier": "default",
+	"description": "Default capabilities for the OpenConcho desktop window",
+	"windows": ["main"],
+	"permissions": [
+		"core:default",
+		{
+			"identifier": "http:default",
+			"allow": [
+				{ "url": "http://*" },
+				{ "url": "http://*:*" },
+				{ "url": "https://*" },
+				{ "url": "https://*:*" }
+			]
+		},
+		"shell:allow-open",
+		"deep-link:default"
+	]
 }

packages/desktop/src-tauri/src/lib.rs

@@ -3,6 +3,7 @@ pub fn run() {
     tauri::Builder::default()
         .plugin(tauri_plugin_http::init())
         .plugin(tauri_plugin_shell::init())
+        .plugin(tauri_plugin_deep_link::init())
         .run(tauri::generate_context!())
         .expect("error while running tauri application");
 }

packages/desktop/src-tauri/tauri.conf.json

@@ -32,5 +32,13 @@
 		"security": {
 			"csp": null
 		}
+	},
+	"plugins": {
+		"deep-link": {
+			"mobile": [],
+			"desktop": {
+				"schemes": ["openconcho"]
+			}
+		}
 	}
 }

packages/web/package.json

@@ -26,6 +26,7 @@
 		"@tanstack/react-query": "^5.74.4",
 		"@tanstack/react-router": "^1.120.3",
 		"@tauri-apps/api": "^2",
+		"@tauri-apps/plugin-deep-link": "^2.4.9",
 		"@tauri-apps/plugin-http": "^2",
 		"@tauri-apps/plugin-shell": "^2",
 		"class-variance-authority": "^0.7.1",

packages/web/src/lib/deep-link.ts

@@ -0,0 +1,40 @@
+import type { Router } from "@tanstack/react-router";
+
+const SCHEME = "openconcho:";
+
+function isTauri(): boolean {
+	return typeof window !== "undefined" && "__TAURI_INTERNALS__" in window;
+}
+
+function navigateFromUrl(router: Router<never, never>, raw: string): void {
+	let parsed: URL;
+	try {
+		parsed = new URL(raw);
+	} catch {
+		return;
+	}
+	if (parsed.protocol !== SCHEME) return;
+
+	const host = parsed.hostname || parsed.pathname.replace(/^\/+/, "").split("/")[0];
+	const search = parsed.search;
+
+	if (host === "explore") {
+		router.navigate({ to: `/explore${search}` as never });
+		return;
+	}
+
+	const path = parsed.pathname.startsWith("/") ? parsed.pathname : `/${parsed.pathname}`;
+	router.navigate({ to: `${path}${search}` as never });
+}
+
+export async function initDeepLinks(router: Router<never, never>): Promise<void> {
+	if (!isTauri()) return;
+	const { onOpenUrl, getCurrent } = await import("@tauri-apps/plugin-deep-link");
+
+	const initial = await getCurrent();
+	if (initial?.length) navigateFromUrl(router, initial[0]);
+
+	await onOpenUrl((urls) => {
+		if (urls[0]) navigateFromUrl(router, urls[0]);
+	});
+}

packages/web/src/main.tsx

@@ -3,6 +3,7 @@ import { createRouter, RouterProvider } from "@tanstack/react-router";
 import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import { DemoProvider } from "./context/DemoContext";
+import { initDeepLinks } from "./lib/deep-link";
 import { routeTree } from "./routeTree.gen";
 import "./index.css";
 
@@ -27,6 +28,8 @@ declare module "@tanstack/react-router" {
 	}
 }
 
+void initDeepLinks(router as never);
+
 const root = document.getElementById("root");
 if (!root) throw new Error("Missing #root element");