ads-dashboard

This is an open-source dashboard for viewing advertising data through the Zernio API. You paste a Zernio API key into the browser and the dashboard displays spend, performance, campaigns, and creatives across multiple ad platforms including Meta, Google, TikTok, LinkedIn, Pinterest, and X. The project is built with Next.js and TypeScript.

The dashboard provides an overview page showing metrics like spend, impressions, clicks, conversions, click-through rate, cost per click, cost per thousand impressions, and return on ad spend. You can pick any date range and compare it against a previous period. There are trend charts for daily, weekly, or monthly data, a sortable campaign table that lets you drill down into ad sets and individual ads, and an ad detail view showing per-ad metrics including video funnel data and the platform's own ad preview. It also shows connection health for every ad account.

The app has no database and no server-side state. Your API key is stored in the browser's local storage and sent with each request to a small proxy route within the app, which forwards the call to the Zernio API. The proxy is deliberately restrictive: it only accepts GET requests, meaning the dashboard can read your ad data but can never modify campaigns. It only allows specific API paths, specifically account and ads endpoints, and nothing else gets forwarded. The key is never logged or stored on the server side.

To run it locally you clone the repository, install dependencies, and start the development server. Then you open the app in your browser and paste your Zernio API key. If you prefer to self-host, you can set the API key as an environment variable and the connect screen is skipped entirely. The project includes unit tests, linting, and a production build script. It is released under the MIT license.