addresszen

Use this skill whenever the user wants address autocomplete, address suggestions as the user types, address validation in a form, US or international address lookup, or any form field that should be auto-populated from a selected address — even if they don't name the package. Specifically covers `@addresszen/address-lookup` (vanilla JS). Includes npm and CDN install, initialisation via `AddressLookup.setup`, callbacks, CSS, country filter/bias, and common gotchas (API key allowed-URLs, source vs CDN build, default US addresses). For the React wrapper, use the `azn-react` skill instead.

Use when integrating the AddressZen API directly via HTTP. Covers authentication (header + query forms), the core lookup endpoints (postcodes, autocomplete, places, cleanse), key/licensee/config admin, data models (PafAddress, MrAddress, AddressSuggestion, etc.), error codes, rate limits, and common gotchas around CORS and allowed URLs.

Use this skill whenever the user wants address autocomplete in a React or Next.js application, address suggestions as the user types in a React form, React address validation, US or international address lookup in JSX, or any React component that should auto-populate fields from a selected address — even if they don't name the package. Covers `@addresszen/react`: install, the `<AddressLookup>` component (default and wrap-around-your-own-input modes), callbacks, CSS, country filter/bias, and the React-specific gotchas (`"use client"` for Next.js App Router, CSS import path, callbacks always see latest closure). For the underlying vanilla JS library and the full option reference, see the AddressZen Address Lookup docs at https://docs.addresszen.com/docs/address-lookup — the option surface is identical except for DOM-coupled options.