This repository is the content engine for roadmap.sh, a popular educational platform that provides structured learning paths for software engineering, data science, and other technical domains. The codebase is primarily a content management system implemented as a monorepo containing thousands of markdown files organized by roadmap (e.g., backend, frontend, devops, AI engineering) along with TypeScript scripts that orchestrate bidirectional synchronization between these markdown files and the roadmap.sh API/database. The actual application logic is minimal: the scripts parse markdown into structured data models, push content to a REST API, pull API data back into markdown, and clean up orphaned content. The vast majority of the repository is static educational content rather than application code, making it a hybrid of a content repository and a lightweight CMS backend. The architecture is tightly coupled to the roadmap.sh platform's specific data model and API endpoints, limiting general reusability but demonstrating a clean pattern for docs-as-code workflows.

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.