feat: ADB smart detection, device info enhancements, Tailwind v4, and codebase refactors

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    name: Lint, Build & Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: './src-tauri -> target'
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install frontend dependencies
+        run: bun install
+
+      - name: TypeScript typecheck
+        run: bun run typecheck
+
+      - name: Clippy
+        run: cargo clippy --manifest-path src-tauri/Cargo.toml -- -D warnings
+
+      - name: Build
+        run: bun run build && cargo build --manifest-path src-tauri/Cargo.toml
+
+      - name: Test
+        run: cargo test --manifest-path src-tauri/Cargo.toml -p kodular-starter

.github/workflows/publish.yml

@@ -28,7 +28,7 @@ jobs:
     runs-on: ${{ matrix.platform }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: install dependencies (ubuntu only)
         if: matrix.platform == 'ubuntu-latest'

CLAUDE.md

@@ -0,0 +1,75 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Is
+
+Kodular Starter is a desktop app (Tauri v2 + React) that enables live USB testing of Kodular/MIT App Inventor apps. It exposes a local HTTP server on port 8004 that the Kodular web IDE communicates with, and bridges to an Android device via ADB (system or built-in `adb_client` crate).
+
+## Commands
+
+**Frontend dev (Vite only, no Tauri):**
+```
+bun run dev
+```
+
+**Full Tauri app (frontend + Rust backend):**
+```
+bunx tauri dev
+```
+
+**Build for production:**
+```
+bunx tauri build
+```
+
+**Type-check TypeScript:**
+```
+bun run typecheck
+```
+
+**Run Rust tests (requires a USB-connected Android device):**
+```
+cargo test -p kodular-starter -- --nocapture
+```
+
+## Architecture
+
+### Frontend (`src/`)
+
+- **`hooks.ts`** — Two React Query hooks, both polling every 3 seconds:
+  - `useServerStatus()` — pings `http://localhost:8004/ping` to check if the local axum server is up
+  - `useDeviceInfo()` — calls Tauri command `device_info` to get connected Android device details
+- **`App.tsx`** — Root component; shows device connection state and a toggleable settings panel
+- **`SettingsPanel.tsx`** — Calls Tauri commands `get_settings`, `save_settings`, `detect_adb_path`, and `pick_adb_path` to manage ADB configuration
+- **`components/`** — Small UI primitives (Button, Field, Input, Select, IconButton, StatusBadge) with Tailwind v4 styling
+- **`lib/cn.ts`** — `cn()` utility combining `clsx` + `tailwind-merge` for conditional class names
+
+### Backend (`src-tauri/src/`)
+
+- **`lib.rs`** — Tauri command handlers exposed to the frontend. Spawns the axum server on startup. Registers `tauri-plugin-single-instance` (refocuses the existing window on duplicate launch). Commands: `device_info`, `adb_status`, `get_settings`, `save_settings`, `pick_adb_path`, `detect_adb_path`, `test_adb_path`.
+- **`adb_commands.rs`** — ADB logic. Supports two modes via `AdbMode` enum:
+  - `Auto`: tries system ADB first (via `ADBServer`), falls back to built-in USB (`ADBUSBDevice`)
+  - `Builtin`: only uses `ADBUSBDevice` (no system adb required)
+- **`adb_resolver.rs`** — ADB binary resolution. `resolve_external_adb_path` walks custom path → `$ANDROID_HOME/platform-tools` → `$ANDROID_SDK_ROOT/platform-tools`, returning `None` to fall back to `$PATH`. `detect_adb_path` extends this with a full `$PATH` search for UI display. `test_adb_path` tests a binary by running `adb version`.
+- **`server.rs`** — Axum HTTP server on `0.0.0.0:8004`. Key endpoints:
+  - `/ping`, `/reset` — liveness check
+  - `/utest`, `/ucheck` — device connection status (returns serial number)
+  - `/replstart/{deviceid}` — launches the Kodular companion app on device
+  - `/settings` — returns current app settings as JSON
+  - CORS is restricted to `*.kodular.io` origins
+- **`settings.rs`** — Reads/writes `AppSettings` (adb_mode + custom_adb_path) using `tauri-plugin-store` (persisted to `settings.json` in the app data directory)
+
+### Key Data Flow
+
+Web IDE (starter.kodular.io) → HTTP to localhost:8004 → axum server → ADB → Android device
+
+Tauri frontend ↔ Tauri commands (invoke) ↔ Rust backend
+
+### Styling
+
+Tailwind CSS v4 via the `@tailwindcss/vite` plugin. Theme tokens are defined in `src/main.css`. No `tailwind.config.js` — configuration is done in CSS using `@theme`.
+
+### Fonts
+
+Uses `Jost` variable font from `@fontsource-variable/jost`.

index.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" href="/favicon.ico" />
+    <link rel="icon" href="/icon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Kodular Starter</title>
     <link rel="stylesheet" href="src/main.css" />

package.json

@@ -1,21 +1,33 @@
 {
-  "name": "starter",
+  "name": "kodular-starter",
   "private": true,
   "version": "0.1.0",
   "type": "module",
+  "imports": {
+    "#/*": "./src/*"
+  },
   "scripts": {
+    "typecheck": "tsc --noEmit",
     "dev": "vite",
     "build": "tsc && vite build",
     "preview": "vite preview",
     "tauri": "tauri"
   },
   "dependencies": {
     "@fontsource-variable/jost": "^5.2.8",
-    "@tanstack/react-query": "^5.100.9",
+    "@nanostores/react": "^1.1.0",
+    "@tailwindcss/vite": "^4.2.4",
     "@tauri-apps/api": "^2.11.0",
+    "@tauri-apps/plugin-dialog": "^2.7.1",
+    "@tauri-apps/plugin-log": "^2.8.0",
     "@tauri-apps/plugin-opener": "^2.5.4",
+    "@tauri-apps/plugin-store": "^2.4.3",
+    "clsx": "^2.1.1",
+    "nanostores": "^1.3.0",
     "react": "^19.2.5",
-    "react-dom": "^19.2.5"
+    "react-dom": "^19.2.5",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.2.4"
   },
   "devDependencies": {
     "@types/react": "^19.2.14",