# Constellation Image Gallery

> Interactive image gallery for React and Tailwind CSS (shadcn/ui) where photos float like stars and their tags form constellations. It is built for exploring by theme: the lines show how photos relate, so visitors follow a thread from one picture to the next instead of scanning a flat grid. Hover or focus a photo and lines connect every photo sharing a tag (a minimum spanning tree, so it reads like a star chart) while the rest dim; click to gather the constellation into a ring around the enlarged photo, Esc scatters it back. Seeded layout, slow idle drift, optional autoplay, light and dark themes, reduced-motion fallback, no dependencies. Use it for portfolios, mood boards and tag-based photo collections.

- Author: [DHxWhy](https://21st.dev/@dhxwhy)
- License: mit
- Tags: Gallery, Image Gallery, Constellation, Network, Interactive
- Live preview: https://21st.dev/@dhxwhy/components/constellation-gallery

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/dhxwhy/constellation-gallery?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/gallery.md