# Style Atlas Explorer — Streamlit + Plotly Dashboard for Style Range & Voiceover Sync

## PURPOSE
An interactive dashboard that lets a student explore the video's **86 code-drawn styles** and inspect how a voiceover syncs to animation. One view plots the whole atlas by complexity against category so the "huge range from simple to really unique" becomes visible; another view lays a word-level SRT on a timeline next to the beats so you can see each word land on a frame. It turns the creator's free style database into something you can filter, compare, and reason about.

## WHY THIS MATTERS
The transcript's promise is range plus consistency: dozens of styles "from simple to really unique," all made from plain JavaScript, all snycable "perfectly to the words." A dashboard makes that abstract claim measurable — you can see the distribution of styles, pick candidates for a topic, and eyeball whether beats align to spoken words before spending tokens.

## HOW TO BUILD
Streamlit for layout, Plotly for charts. Load the catalog into a DataFrame, then render a scatter of complexity vs. category and a Gantt-style timeline of words and beats.

```python
import streamlit as st, plotly.express as px, pandas as pd

df = pd.DataFrame(catalog)
st.plotly_chart(px.scatter(df, x="category", y="complexity",
                color="complexity", hover_name="name", title="Style Atlas"))

fig = px.timeline(srt_df, x_start="start", x_end="end", y="word")
fig.update_yaxes(autorange="reversed")
st.plotly_chart(fig, title="Word-level SRT")
```

Add a sidebar filter for complexity/category, a topic text box, and a button that assembles the copy-ready prompt from the selected style — reusing the same templating logic as the other tools.

## WHEN TO USE IN PRODUCTION
Best as an internal style-picker and review surface for a content team, or a public "browse the styles" page. Use it to shortlist styles and sanity-check sync. Do **not** use it for automated QA in CI (the CLI is better) or for rendering — the dashboard only informs the choice.

## HOW IT HELPS STUDENTS
Practises Streamlit state and widgets, Plotly Express expressive charts including timelines, and Pandas data shaping — the standard data-app stack for presenting model or media output.

## STARTER CODE
`starter/main.py` builds a deterministic catalog and a sample word-level SRT, renders the atlas scatter and sync timeline, and marks TODOs for filters and prompt export.
