⚔ The Top Chiefs
Sign in

About The Top Chiefs Website

This website is a passion project built by members of The Top Chiefs clan to provide in-depth analytics and insights for our clan's performance in Clash of Clans. Have questions or suggestions? Feel free to email us at topchiefsclash@gmail.com or send a Discord message to _naddy. (Includes underscore and period in the username).

Our Story

Rebuilt in 2024, The Top Chiefs started as a small group of friends who shared a love for Clash of Clans. Over the years, we've grown into a competitive clan with members from around the world. This website is our way of sharing our journey and insights with the community.

How this Website Works

There is an official Clash of Clans API that provides access to a lot of unavailable or hard-to-access data about clans, wars, and player metrics. We have a data pipeline that regularly pulls this data, processes it, and stores it in a way that allows us to build the various analytics and AI features you see on the site. The website is built with modern web technologies to provide a fast and responsive experience. This is largely simplified for the sake of brevity, but if you're interested in more technical details, check out the Tech Stack section below or reach out to us directly!

Tech Stack

Data Pipeline & Storage

  • Dagster—Orchestrates the full Bronze → Silver → Gold pipeline on scheduled jobs
  • dbt + DuckDB—Transforms raw JSON into cleaned Parquet files
  • Azure Blob Storage—Stores bronze, silver, gold files in data lake for long-term storage
  • PostgreSQL—Holds the final Gold tables, all pipeline/backend event logs, and backend tables

Backend

  • FastAPI—Exposes all game data as JSON REST endpoints and streams AI responses via Server-Sent Events

Frontend

  • React/Next.js—React Server Components fetch data server-side
  • TypeScript—End-to-end type safety across components and API contracts
  • Tailwind CSS—Utility-first styling with a dark slate and amber theme

AI

  • Gemini API—Powers the AI chat feature. Answers natural-language questions about clan stats using a tool-calling loop backed by our data

Observability

  • Grafana—Monitors pipeline health, backend request traffic, and AI chat usage

Cloud Infrastructure

  • Terraform + Azure—Infrastructure-as-code for deploying the full platform to Azure