ScaleDynamics Developer Documentation
Hardware Intelligence for the Web: End Hardware Blindness.
Welcome to the ScaleDynamics documentation. Our tools provide your applications with deterministic, real-time metrics on your users' actual hardware execution capacity: the BDP (Browser Device Performance) and AIR (AI Readiness) indices.
➡️ Have a look to our Hardware Intelligence core concepts to understand what are BDP and AIR indices.
Whether you are here to run a passive 7-day audit for your analytics team or actively build hardware-aware fallbacks in your frontend code, you are in the right place.
📊 For the 7-Day Audits
The ScaleDynamics Agent sd-agent.js is an ultra-lightweight (10KB), asynchronous script designed for pure observability.
It silently captures the hardware execution ceiling of the devices hitting your site without affecting your Core Web Vitals.
After deployment, what this script does:
- Maps your traffic and conversion leaks across the 4 physical BDP and AIR tiers.
- Provides the foundation for the ScaleDynamics 7-Day Baseline Report.
➡️ Go to the sd-agent.js Installation Guide
⚡️ For Active Frontend Control and Analytics Integrations
The sd-metrics.js script turns observation into action. It exposes the BDP and AIR scores directly to your frontend at runtime,
allowing you to build dynamic, hardware-aware applications with just a few lines of code. You can also use it to extend your current
analytics (GA4, amplitude, ...) with BDP and AIR new dimensions.
What this script does:
- BDP (UX Adaptation): Catch the device's execution tier (BDP 1 to 4) to dynamically downgrade heavy WebGL/JavaScript on entry-level devices, or unlock rich experiences for high-end hardware.
- AIR (AI Routing): Score the client's readiness for local AI (AIR 1 to 4). Execute smaller LLMs locally via WebGPU/WebNN for capable devices, and safely route prompts to your Cloud APIs for older hardware to prevent browser crashes.
➡️ Go to the sd-metrics.js Installation Guide
Need Help?
- Not sure which script is right for your architecture, or interested in the automated ScaleDynamics Adaptive Engine for complex Single Page Applications? Contact our Solutions Architecture Team support@scaledynamics.com
- Want to check what device data are captured, and how are built our scripts? Check security, privacy and performance specification