> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brighthive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WebApp

> React-based webapp serving as the Brighthive platform UI with data catalog, BrightAgent, collaboration, and configuration.

## Overview

The Brighthive webapp is a React application that serves as the central interface for all platform features. Built with Apollo GraphQL Client for real-time data fetching and Stream.io for team collaboration.

## Core Sections

<CardGroup cols={2}>
  <Card title="Data Catalog" icon="book">
    Browse and search your data assets. See schemas, metadata, lineage, and quality scores — all powered by the Neo4j knowledge graph.
  </Card>

  <Card title="BrightAgent" icon="robot">
    Conversational AI interface for querying data, generating visualizations, building dbt models, and exploring your data estate through natural language.
  </Card>

  <Card title="Connect" icon="plug">
    Onboard data through file uploads to S3 or by configuring Airbyte connectors for external data sources.
  </Card>

  <Card title="Govern" icon="shield">
    Define schemas, manage data policies, explore the data catalog, and review data quality metrics.
  </Card>

  <Card title="Build" icon="hammer">
    Create projects, manage workflows, and access BrightAgent Studio for custom agent configurations.
  </Card>

  <Card title="Configure" icon="gear">
    Platform settings including ingestion sources (Airbyte), warehouse connections (Redshift/Snowflake), and transformation configs (DBT Cloud).
  </Card>
</CardGroup>

## Technology Stack

* **React + TypeScript** — Component-based UI with static typing.
* **Apollo Client** — GraphQL data fetching and state management, connected to the platform's Apollo Federation API.
* **Material-UI + TailwindCSS** — UI component library and utility-first styling.
* **Stream.io** — Real-time team collaboration and chat embedded in the platform.
* **AG Grid Enterprise** — High-performance data tables for browsing large datasets.
* **Monaco Editor** — Code editing interface for reviewing generated SQL, dbt models, and notebooks.

## Real-time Collaboration

Stream.io integration enables team collaboration directly within the platform:

* Chat with team members while exploring data.
* Share BrightAgent insights and visualizations.
* Discuss data quality issues and governance decisions in context.

## Deployment

* Hosted on **AWS Amplify** with dev, staging, and production environments.
* Authenticates via **Cognito** (JWT tokens) against the platform's user pools.
* Communicates with the backend via **GraphQL** (`REACT_APP_GRAPHQL_URL`) and BrightAgent via its API (`REACT_APP_BB_ASSISTANT_URL`).