Ad-Preflight

Stop getting HTML5 ads rejected. Validate, auto-fix, and package creatives before you upload — works with any platform that accepts HTML5 ads.

Works with: Google Ads · DV360 · Doubleclick · Sizmek · Adform · and any platform following IAB HTML5 ad standards

Quick start

npm install -g @ad-preflight/cli
ad-preflight package ./my-ad --fix

✔ Ad validated
✔ Auto-fixed: clickTag injected, ad.size meta added
✔ Zip created: compliance_my-ad.zip (48 KB — under 150 KB limit)
✔ Original backed up: my-ad_original.zip

What it catches — and what it fixes

Validation check	Auto-fix (`--fix`)
Missing or incorrect `<meta name="ad.size">`	✅ Injects from CSS dimensions
Missing click handler (clickTag, Enabler API, Exit API)	✅ Injects clickTag variable
HTTP references (rejected by ad platforms)	✅ Converts to HTTPS
Bundle exceeds size limit (150KB / 600KB / 5MB)	—
Non-standard IAB dimensions	— (warns; fails with `--strict-dimensions`)
Spoofed file extensions (magic-number check)	—

With --fix, originals are backed up to {folder}_original.zip so nothing is lost.

Works wherever you work

Use case	How	Guide
Terminal	`ad-preflight package ./ad --fix` — human-friendly output with optional browser preview	CLI guide
CI/CD	`ad-preflight package ./ad --json` — single JSON on stdout, exit codes 0/1/2, auto machine mode	CI/CD guide
AI agents (Cursor / MCP)	`validate_ad_creative` tool — agents validate and fix ads without leaving the editor	MCP setup

Same validation logic everywhere. Output adapts automatically: human-friendly in a TTY, machine-readable JSON when piped or with --json.

Free vs Pro

Capability	Free	Pro
Static validation (meta tags, ClickTag, HTTPS, file types, size limits)	✅	✅
Auto-fix mode (`--fix`)	✅	✅
IAB dimension validation	✅	✅
ZIP packaging (upload-ready output)	✅	✅
CI/CD and MCP integration	✅	✅
Local preview (publisher-style page)	✅	✅
Headless browser validation (`--deep`)	—	✅
CPU & performance profiling	—	✅
Network waterfall analysis	—	✅
Visual snapshots	—	✅

Get started free. Upgrade when you need runtime validation.

ad-preflight buy or visit ad-preflight.com

License management:

ad-preflight buy                    # Purchase or join waitlist
ad-preflight activate <license-key> # Activate on this machine
ad-preflight license                # Check license status

Each Pro license supports up to 2 machines. Core features remain free forever.

Installation

Global (recommended):

npm install -g @ad-preflight/cli
ad-preflight --help

Project dependency:

npm install --save-dev @ad-preflight/cli
npx @ad-preflight/cli package ./ad

For pipeline setup, see the CI/CD guide. For Cursor/MCP, see MCP setup.

Documentation

CLI guide — Commands, options, examples, local preview
CI/CD guide — Machine mode, exit codes, JSON schema, pipeline examples
MCP setup — Config, validate_ad_creative tool, Cursor examples

License

See LICENSE.md.

@ad-preflight/cli

Quick Install