Getting Started

Welcome to Overscore — the platform for deploying and sharing AI-built React dashboards.

Overscore gives data analysts, engineers, and operators a way to take any React dashboard — built with Claude Code, Cursor, or any AI coding tool — and ship it to a secure, shareable URL in seconds. No frontend team required. No ticket queue. Just your data, your way.

This guide walks you through creating an account, setting up your first project, and understanding the core workflow. By the end, you'll be ready to deploy your first dashboard.


Prerequisites

Before you begin, make sure you have the following:

  • Node.js 18+ — required to run the CLI and build your dashboard locally. Download Node.js
  • A Google account — used for signing in to Overscore and authenticating your team
  • A Google Cloud project with BigQuery enabled — the free tier is more than enough to get started. If you don't have one yet, don't worry — you can set it up later when you're ready to connect live data.

How it works

The Overscore workflow has three steps:

  1. Build — Use any AI coding tool (Claude Code, Cursor, Windsurf, etc.) to generate a React dashboard. Describe what you want in plain English, iterate until it looks right, and you're done.

  2. Deploy — Run a single command from your terminal:

    npx @overscore/cli deploy
    

    The CLI bundles your dashboard, uploads it, and gives you a live URL.

  3. Share — Send the link to your team. They sign in with Google and see your dashboard instantly. No accounts to provision, no passwords to manage.

That's it. Build, deploy, share.


What you get

Every dashboard deployed to Overscore includes:

  • Secure hosting — your dashboards run on fast, globally distributed infrastructure
  • Google OAuth — viewers sign in with their Google account; you control who has access
  • BigQuery proxy — dashboards query BigQuery through a secure server-side proxy, so credentials never touch the browser
  • Data caching — built-in DuckDB-WASM + Parquet caching keeps dashboards fast and reduces BigQuery costs
  • Team sharing — invite teammates to your project and manage access from the hub

Sign up

  1. Go to overscore.dev and click Sign in with Google
  2. Authorize with your Google account
  3. You're in

Overscore is free during beta — no credit card required, no usage limits. Just sign in and start building.


Create your first project

Once you're signed in, you'll land on your dashboard. Here's how to create a project:

  1. Click New Project
  2. Give it a name (e.g., "Acme Analytics")
  3. Set a slug — this becomes part of your dashboard URLs (e.g., acmeoverscore.dev/d/acme/my-dashboard)
  4. Click Create

Each project is a workspace that contains:

  • One or more dashboards you deploy via the CLI
  • A BigQuery connection for querying live data
  • Team members you invite to view or manage the project

You can create multiple projects to organize dashboards by team, client, or use case.


Next steps

You're all set up. Here's where to go from here:

  • Quick Start — A hands-on tutorial that walks you through building and deploying your first dashboard end to end
  • Core Concepts — Understand how projects, dashboards, deployments, and the BigQuery proxy fit together
  • BigQuery Setup — Connect your Google Cloud project and start querying live data from your dashboards

If you run into anything, reach out — we're building this for people like you and we want to hear what's working and what isn't.