This repository is a monorepo for `driver.js`, a lightweight, zero-dependency JavaScript library for creating product tours, feature highlights, and contextual hints on web pages. The core library is in `packages/driver/` and exports two main factories: `driver()` for guided tours with an overlay cutout and popover, and `hints()` for persistent beacon-style hints. The architecture follows an instance-based pattern where each driver or hints instance owns its configuration, state, and event emitter, avoiding global state. Key modules include a pure-geometry positioning system (`position.ts`), an SVG overlay with animated stage transitions (`overlay.ts`, `stage.ts`), a popover renderer shared between tours and hints (`popover.ts`), and capture-phase click handling with `WeakMap`-based listeners (`click.ts`). The library has no runtime dependencies, comprehensive test coverage (vitest + jsdom), and supports keyboard navigation, animation, theming via CSS custom properties, and lifecycle hooks. The monorepo also includes two Astro-based applications: `apps/docs` (documentation site with live code samples) and `apps/playground` (interactive examples). The codebase demonstrates strong engineering practices with clean abstractions, instance isolation, and reusable primitives.
Wox is a cross-platform desktop launcher (macOS, Linux, Windows) written in Go with a custom retained-mode UI framework. It provides a keyboard-first search interface with an extensive plugin system (system plugins in Go, external plugins via WebSocket hosts for Python and Node.js). Core features include file search with content indexing (SQLite FTS5, USN journal, FSEvents), clipboard history, calculator, converter, emoji picker, screenshot with annotation, window management, AI chat with multiple providers (OpenAI, Ollama, etc.), cloud sync with encryption, and system commands (shell, timer, dictation). The architecture is a monolith with a plugin manager dispatching queries to registered plugins, rendering results in a custom widget tree with GPU-accelerated painting. It has a sophisticated settings system with typed definitions, migrations, and cloud sync. The codebase is large but well-organized, with extensive platform-specific code for Windows (COM, Win32), macOS (AppKit, Objective-C), and Linux (GTK, Wayland, X11).
This is a Flutter package for creating step-by-step showcase/onboarding tours. It highlights widgets with tooltips, supports custom tooltip widgets, auto-play, animations, and multiple scopes. The architecture uses a service locator pattern (ShowcaseService) to manage independent showcase scopes without requiring BuildContext. The overlay system uses a custom ShapeClipper to cut out holes around target widgets. The code is well-organized and actively maintained, though it lacks unit tests.
monkeSearch is a macOS-native file search tool that uses a local LLM to parse natural language queries into structured search parameters, then executes Spotlight searches via PyObjC. The system breaks queries into file type indicators (with specificity detection), temporal expressions, and residual keywords, converting them to NSPredicates using UTIs for file type matching and date comparisons for temporal filtering. It features a clean separation between LLM-based query parsing (query_gen.py) and Spotlight execution (parser.py), with the former being particularly well-engineered for reuse. The tool is designed for offline, agentic use with no cloud dependencies, targeting low-resource environments.