How it works
under the hood.

A breakdown of the stack and pipeline that runs every scan.

The Creative Stack

Nuxt 4 (Stay progressive)

Handles the reactive frontend and layout. Uses Nitro server routes (/server/api/) to run backend scripts. Content is sent to the browser in immediate chunks rather than waiting for the whole page to build on the server (SSR).

Puppeteer (The Auditor)

We launch a headless Chromium browser on the server, load the page like a real visitor would, and observe every network request in real time. As assets are downloaded, we measure their transfer sizes and automatically group them into categories such as HTML, JavaScript, CSS, and images.

Supabase (The Data Hub)

We store audit history and page metrics in PostgreSQL, allowing reports to be tracked over time. To protect user data, access is restricted through Row Level Security (RLS), while heavier calculations are cached so we don’t need to rerun expensive browser analyses.

The Carbon Calculation Pipeline

User Request: The user enters a URL on the frontend.

Puppeteer Spin-up: Nuxt triggers a server-side headless browser.

Data Harvesting: Puppeteer tracks and logs asset network sizes.

Carbon Translation: Raw bytes are passed into the carbon logic formula.

Database Sync: Supabase records the audit for history and dashboard analytics.

UI Render: The frontend translates data into scannable percentage breakdowns.

What's Baking for V2

Let's map out the next iteration to make these sustainability insights even more green!

Framework Detection (Smart tips)

The auditor will sniff out if a site is running on Nuxt, Next.js, WordPress, or vanilla code. Instead of generic advice, you will get optimizations feedback for your creative stack.

SSR vs. SPA Analysis (Under the hood)

By inspecting the page’s initial server response, we can tell whether a site is rendered on the server or assembled later in the browser with client-side JavaScript. That allows us to give recommendations tailored to how the site actually works, instead of relying on generic performance advice.