Upload README.md with huggingface_hub

README.md

@@ -1,10 +1,42 @@
 ---
-title: Dropthe Entity Explorer
-emoji: 📈
-colorFrom: purple
+title: DropThe Entity Explorer
+emoji: 🔍
+colorFrom: blue
 colorTo: indigo
 sdk: static
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# DropThe Entity Explorer
+
+An interactive data exploration tool built by [DropThe](https://dropthe.org), the data utility media network that covers entertainment, technology, finance, and culture through structured knowledge graphs.
+
+## What Is This?
+
+The DropThe Entity Explorer is a demonstration of how [DropThe](https://dropthe.org) organizes and connects millions of data points across entertainment, crypto, companies, and people. The knowledge graph behind DropThe contains over 1.8 million entities and nearly 3 million relationships, making it one of the most densely connected independent media databases available today.
+
+This Space provides a sample view into the entity system. You can browse entities by category — movies, series, cryptocurrencies, companies, and notable people — and see how each entity connects to others through typed relationships like "directed by," "stars in," "founded," and "competes with."
+
+## How the Knowledge Graph Works
+
+Every entity in the DropThe system has structured metadata stored as JSON, including fields like popularity scores, financial metrics, biographical data, and media availability. Entities are linked through a dedicated relationship table that supports bidirectional traversal. For example, querying a director returns all their films, and querying a film returns its full cast and crew — all from the same graph.
+
+The entity types currently supported include:
+
+- **Movies** — 40,000+ titles with streaming availability, cast, crew, and ratings
+- **Series** — Television shows with season and episode metadata
+- **People** — Actors, directors, executives, athletes, and public figures
+- **Cryptocurrencies** — Tokens and coins with real-time pricing data
+- **Companies** — Corporations with financial data, leadership, and industry classification
+
+## About DropThe
+
+[DropThe](https://dropthe.org) is a data utility media network that publishes structured, research-driven content across multiple verticals. Every article, ranking, and comparison on the platform is backed by the same entity graph that powers this explorer. The platform prioritizes data transparency and never claims to have physically tested products — all analysis is based on publicly available data, official specifications, and algorithmic scoring.
+
+The full entity database is updated continuously through automated enrichment pipelines that pull from public APIs, official filings, and structured data sources. This Space shows a static sample, but the live site at dropthe.org reflects the most current data.
+
+## Technical Details
+
+This is a static HTML application hosted on Hugging Face Spaces. It uses vanilla JavaScript with no external dependencies. The sample data is embedded directly in the page for demonstration purposes. The production system uses PostgreSQL with PostGIS extensions and Supabase for the API layer.
+
+Visit [dropthe.org](https://dropthe.org) to explore the full knowledge graph.