← Back to archive

Repo of the Day

GoogleChrome/modern-web-guidance

Published: Nov 16, 2026

Open repository ↗

Keep your coding agent up to date with the latest web best practices

Summary

Modern Web Guidance is a collection of web-platform skills and a CLI that brings current browser APIs, implementation guidance, accessibility considerations, and compatibility information into coding agents. It aims to steer agents away from legacy JavaScript and heavy polyfills toward browser-native CSS, DOM, and JavaScript capabilities.

What it is useful for

Use it when an agent needs help with modern front-end work such as dialogs, popovers, forms, navigation, responsive layouts, animations, rendering performance, or accessibility. The documented catalog contains 262 modern web features across CSS and layout, HTML and DOM, and JavaScript and APIs. It also covers browser-based AI capabilities such as native translation, summarization, and language detection.

For example, an engineer can:

  • Search for guidance on animating a dialog backdrop and retrieve a focused guide on top-layer transitions.
  • Ask about building a tooltip or popover and receive guidance involving Anchor Positioning or the Popover API, including keyboard and screen-reader considerations.
  • Scan an existing repository for legacy patterns before asking an agent to modernize them.
  • Find implementation patterns for container queries, subgrid, oklch, View Transitions, scheduler.yield, :user-invalid, and other recently developed platform features.

The project is a reference layer for coding agents, not a runtime framework. Its guides are designed to be token-efficient, with lower-value common content pruned through evaluations, so engineers should confirm that a guide exists for their specific feature. The README recommends sensible, lightweight fallbacks but does not define a universal browser-support policy; fallback choices still need to match the application’s requirements.

How engineers can use it

The README provides commands that can be tried without installing the project:

# Search for relevant guides
npx modern-web-guidance@latest search "animate a dialog modal backdrop"

# Retrieve a guide by ID
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"

# Scan a codebase for legacy patterns to modernize
npx modern-web-guidance@latest legacy-scan .

To install the guidance into a coding-agent setup, run:

npx modern-web-guidance@latest install

This launches an interactive wizard. The quickstart does not enumerate each agent-specific configuration, so engineers should use the wizard and consult the README’s “Alternative Installation Methods” section rather than assuming a manual installation format. Once installed, the skills can guide an agent’s implementation work while the engineer retains responsibility for choosing appropriate fallbacks and validating browser compatibility.