mediawall-ui
A free, open-source shadcn/ui registry of React components for TV planning: screen size, seating distance and mount height over a console, with a to-scale wall elevation. Made by GetMediaWall; to plan the whole wall around the TV, try our Design Your Wall planner.
Live demo · Source on GitHub · MIT licence · React 19, Tailwind 4, shadcn/ui

Install
In a project that already uses shadcn/ui, add any item by URL. The CLI also installs the card, input, label and badge primitives the components use.
npx shadcn@latest add https://getmediawall.github.io/mediawall-ui/r/tv-wall-planner.json
| Item | What you get |
|---|---|
tv-wall-planner | All three cards laid out as one section (block) |
tv-size-calculator | Width and height from the diagonal (16:9, 21:9, 4:3), to-scale outline |
seating-distance | THX 40° to SMPTE 30° range, plus a verdict and ideal TV sizes for your own seat |
mount-height | Centre, bottom and top edge over a console or mantel, with a wall elevation drawing |
mediawall-planner | Just the maths: TypeScript, no dependencies |
Use
import { TvWallPlanner } from "@/components/tv-wall-planner"
import { SeatingDistance } from "@/components/seating-distance"
<TvWallPlanner />
<SeatingDistance units="metric" defaultDiagonal={77} />
How the numbers are worked out
- Size: width = diagonal × 16/√337, height = diagonal × 9/√337 for 16:9 screens.
- Seating: from a 40° horizontal field of view (THX recommendation) to 30° (SMPTE EG-18 minimum).
- Height: screen centre at seated eye height (42" by default). Over furniture, the centre is raised up to 4" to leave a 3" gap. If that is not enough, the card shows how far the TV still overlaps.
These are typical values. The TV and mount makers' instructions, and local building and electrical codes, always win. Prefer a pro? Find a TV installer near you.
Quality
Unit tests cover the maths. On every commit, CI installs each item into a fresh Next.js app with npx shadcn add and builds it.
Written with AI assistance (Claude) and tested by the GetMediaWall team. Related: django-mediawall for Django sites.