Honesty First: What BrandSpy Can (and Cannot) Actually Do
In an industry full of AI hype and false promises, we want to set the record straight about exactly what BrandSpy is, how our technology works under the hood, and what its hard limitations are.
The TL;DR
BrandSpy is a deterministic heuristic engine. We use a headless browser to read hard mathematical facts from a website's CSS and Computed DOM (like hex codes, font sizes, and container widths). We do not use AI to "guess" a redesign, and we cannot magically reconstruct a perfect layered Figma file from minified React code.
What You Are Actually Paying For (The "Can Do's")
BrandSpy excels at extracting raw mathematical properties from live websites. When you run a URL through our engine, here is exactly what we guarantee:
1. Mathematical Typography Scales
We extract every single font-size on the page and run a mathematical regression to guess the closest geometric growth ratio (e.g., Golden Ratio, Major Third). We also calculate physical line-height rhythms.
2. Color Science & APCA Contrast
We pull every HEX code from the DOM. Then, we apply strict WCAG 3.0 APCA contrast math, simulate protanopia/deuteranopia color blindness, and plot the colors on an HSL wheel to mathematically verify color harmony.
3. 8-Point Grid Detection
We scrape every margin and padding value on the site and calculate the percentage of those values that are perfectly divisible by 8 or 4. This tells you how strict the frontend engineers were.
4. 1:1 Professional Exports
We compile these raw variables into syntax-perfect tailwind.config.js palettes, standard CSS variables, and native JSON for Tokens Studio for Figma.
The Hard Limitations (The "Cannot Do's")
We refuse to over-promise. Here are the things our tool (and frankly, any tool on the market) cannot do, because it is technologically impossible:
1. We cannot reconstruct a perfect Figma File
Web browsers flat-pack designs into the DOM. We cannot reconstruct named layers, auto-layout logic, or component variants. We can give you the Design Tokens (colors, fonts, spacing), but you must redraw the components.
2. We cannot read the original designer's intent
If a developer hardcoded margin-top: 23px by accident instead of their intended 24px grid value, our tool will report 23px. We read code, not minds.
3. We cannot bypass authentication or CAPTCHAs
BrandSpy cannot scrape password-protected dashboards, internal staging environments, or sites with aggressive Cloudflare anti-bot protection.
4. Interactive States (Hover/Focus) are limited
We simulate basic hover states to grab interactions, but complex WebGL animations or deeply nested React state-changes won't be captured accurately by our static pass.
The Bottom Line
BrandSpy is an analytical microscope for frontend engineers and design system architects. It saves you 45 minutes of digging through Chrome DevTools by automating the extraction and math. It produces high-quality tokens. It is not an AI magic wand that steals competitor websites with one click.
If you're a professional looking to analyze a competitor's geometric typography scale, check APCA contrast for a client, or generate a 50-950 Tailwind palette from a reference brand, BrandSpy is built for you.