What is ads-dashboard?

zernio-dev/ads-dashboard — explained in plain English

Analysis updated 2026-07-26

★ 10TypeScriptAudience · pm founderComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((repo))
    What it does
      Shows ad spend metrics
      Compares date ranges
      Displays campaign data
    Ad Platforms
      Meta and Google
      TikTok and LinkedIn
      Pinterest and X
    Tech stack
      Next.js framework
      TypeScript language
      Browser local storage
    Security
      Read-only API proxy
      No server-side storage
      Key stays in browser
    Use cases
      View ad performance
      Compare campaign trends
      Self-host ad dashboard
    Setup
      Clone and install
      Paste API key
      Optional self-host env var

mindmap root((repo)) What it does Shows ad spend metrics Compares date ranges Displays campaign data Ad Platforms Meta and Google TikTok and LinkedIn Pinterest and X Tech stack Next.js framework TypeScript language Browser local storage Security Read-only API proxy No server-side storage Key stays in browser Use cases View ad performance Compare campaign trends Self-host ad dashboard Setup Clone and install Paste API key Optional self-host env var

What do people build with it?

USE CASE 1

View all your ad spend and performance metrics across Meta, Google, TikTok, and more in one dashboard.

USE CASE 2

Compare ad performance between two date ranges to see if results are improving over time.

USE CASE 3

Drill down from campaign-level data into individual ads to see which creatives perform best.

USE CASE 4

Self-host a read-only ad reporting tool so your team can check metrics without risking accidental changes.

What is it built with?

TypeScriptNext.js

How does it compare?

	zernio-dev/ads-dashboard	acoyfellow/auto-thinking-pi	bbdaii/three-pivot-controls
Stars	10	10	10
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	easy	moderate	easy
Complexity	2/5	3/5	2/5
Audience	pm founder	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a Zernio API key to view ad data, but the app runs with a standard install and has no database or server-side state.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

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.

Copy-paste prompts

Prompt 1

Help me set up the Zernio ads dashboard locally. I have cloned the Next.js repo, what are the exact steps to install dependencies, start the dev server, and connect my Zernio API key?

Prompt 2

I want to self-host this ads dashboard for my team. How do I configure the API key as an environment variable so the connect screen is skipped, and what is the safest way to deploy it?

Prompt 3

Explain how the read-only proxy route works in this dashboard. Why does it only allow GET requests to specific account and ads endpoints, and how does that protect my ad campaigns?

Prompt 4

I want to add a new ad platform to this dashboard. Walk me through how the Zernio API endpoints are called and how I would extend the campaign table and trend charts to support it.

Frequently asked questions