United States (US)
Quick facts
Section titled “Quick facts”| Field | Value |
|---|---|
| Drive side | Right-hand |
| Language(s) | English |
| Regulator | FHWA |
| Code format | W1-1 / R2-1 / D5-1 / M1-1 |
| Standard | MUTCD (Manual on Uniform Traffic Control Devices) — FHWA |
The @road-signs/us package contains US road signs from the Manual on Uniform Traffic Control
Devices (MUTCD), published by the Federal Highway Administration (FHWA). Signs are sourced
from Wikipedia / Wikimedia Commons and are in the public domain.
Installation
Section titled “Installation”npm install @road-signs/usSign categories
Section titled “Sign categories”| Category | MUTCD series | Description |
|---|---|---|
warning |
W series | Warn drivers of conditions ahead — diamond-shaped, yellow |
regulatory |
R series | Inform drivers of laws and regulations — white/red |
guide |
D/G series | Destination and mileage information — green/blue |
school |
S series | School zone and pedestrian crossing — fluorescent yellow-green |
construction |
C series | Work zone signs — orange |
recreational |
RA series | Recreation and cultural interest — brown |
informational |
M/I series | Motorist services and general information |
import { signs, getSign, getSignByCode, getSignsByCategory } from '@road-signs/us';
// Example below uses the real US sign "W1-1R" — adjust to taste.
// All signssigns.length;
// By slug IDconst sign = getSign("w1-1r-turn-right");
// By sign codeconst s = getSignByCode("W1-1R");
// All warning signsconst filtered = getSignsByCategory("warning");import { getSignsByCategory } from '@road-signs/us';import { RoadSign } from '@road-signs/react';
const warningSigns = getSignsByCategory("warning");
export default function USGrid() { return ( <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}> {warningSigns.map((sign) => ( <RoadSign key={sign.id} sign={sign} size={64} /> ))} </div> );}<script setup>import { getSignsByCategory } from '@road-signs/us';import { RoadSign } from '@road-signs/vue';
const warningSigns = getSignsByCategory("warning");</script>
<template> <div style="display:flex;gap:8px;flex-wrap:wrap"> <RoadSign v-for="sign in warningSigns" :key="sign.id" :sign="sign" :size="64" /> </div></template>Coverage
Section titled “Coverage”| Metric | Value |
|---|---|
| Signs scraped | 1521 |
| Signs with SVG | 1449 |
| Missing SVG | 72 |
| Overall | 95% |
| Category | Scraped | With SVG | Missing | % |
|---|---|---|---|---|
warning |
367 | 362 | 5 | 99% |
regulatory |
559 | 557 | 2 | 100% |
guide |
312 | 312 | 0 | 100% |
school |
23 | 18 | 5 | 78% |
construction |
56 | 56 | 0 | 100% |
recreational |
56 | 56 | 0 | 100% |
informational |
148 | 88 | 60 | 59% |
Standard: MUTCD (Manual on Uniform Traffic Control Devices) — FHWA
SVG sources:
- FHWA MUTCD Standard Highway Signs (ZIP)
- Wikimedia Commons — MUTCD signs
- Wikipedia — Manual on Uniform Traffic Control Devices
Coverage data is also published in the @road-signs/docs package.
TypeScript types
Section titled “TypeScript types”import type { USSign, USCategory } from '@road-signs/us';
type USCategory = 'construction' | 'guide' | 'informational' | 'recreational' | 'regulatory' | 'school' | 'warning';
interface USSign { id: string; // e.g. "w1-1-turn" code: string; // e.g. "W1-1" name: string; // e.g. "Turn" description: string; category: USCategory; svg: string; // inline SVG string assets: { svg: string; png: Record<number, string>; jpg: Record<number, string>; webp: Record<number, string>; };}