`README.md`

33 lines
# trending-dw — Trending Bestseller Intelligence

`trending.designerwallcoverings.com` — an Amazon-style dashboard of what's selling across
Google data points and print-on-demand marketplaces (Spoonflower, Etsy, Society6, Creative
Market, William Morris et al): **which company, which item, which marketplace, and its
bestseller signal**.

## Run
```
npm start          # http://127.0.0.1:9948  (basic-auth admin:DW2024!)
npm run seed       # rebuild data/bestsellers.json from research
```

## Layout
- **Left panel (Amazon-style facets):** Marketplace · Company · Style · Color · Price, with live counts + click-to-filter.
- **Top bar:** result count · Sort (Bestseller signal / Newest / Title / Company / Marketplace) · Density slider.
- **Grid:** "new"-style cards (swatch tile from dominant color, NEW ribbon, signal rank), infinite-scroll.
- All three DW hard-rule grid controls present: **sort + density + infinite scroll**.

## Data
`data/bestsellers.json` is generated by `scripts/seed.js` from the 2026-07-02 design-trend-scout
Exa research. To keep it live, re-run design-trend-scout on a schedule and regenerate the seed
(the refresh feed is the intended next wiring — see below).

## Gated switches (Steve flips)
- **Public go-live:** set `BASIC_AUTH=''` to remove the auth gate (default is gated — it publishes competitor intelligence).
- **DNS:** `trending` CNAME/A on Cloudflare → Kamatera `45.61.58.125`.
- **Deploy:** `/deploy` to Kamatera (pm2 `trending-dw`).
- **Live Google/POD feed:** wire `scripts/seed.js` to the design-trend-scout Exa pipeline for scheduled refresh (metered — show cost).

## Notes
- **No copyrighted marketplace images** are stored/served — cards render color-swatch tiles. This is intentional (copyright + it's a public DW subdomain).