Skip to content
VenusUI
Get started

Wall Calendar

A hanging calendar whose pages flip from the binding, with single-day or range selection.

Preview

Installation

npx shadcn@latest add @venusui/wall-calendar

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/components/ui/wall-calendar.tsx

Usage

The code behind the preview above.

wall-calendar-demo.tsx

import { WallCalendar } from "@/components/ui/wall-calendar"

// Photos: Unsplash (free under the Unsplash License).
const photo = (id: string) => `https://images.unsplash.com/photo-${id}?w=640&h=320&fit=crop&auto=format&q=75`

const photos = [
  { src: photo("1501785888041-af3ef285b470"), alt: "Rowing boats on a turquoise lake below mountains" },
  { src: photo("1507525428034-b723cf961d3e"), alt: "Gentle waves on a beach at sunrise" },
]

export default function WallCalendarDemo() {
  return (
    <WallCalendar
      mode="range"
      defaultMonth={new Date(2027, 5, 1)}
      defaultSelected={{ from: new Date(2027, 5, 9), to: new Date(2027, 5, 13) }}
      photos={photos}
    />
  )
}

API reference

PropTypeDefaultDescription
defaultMonthDate—Month shown first. Required so server and browser match.
mode"single" | "range""single"Pick one day or a range.
selected{ from: Date | null; to: Date | null }—Controlled selection.
defaultSelected{ from: Date | null; to: Date | null }—Initial selection.
onSelectedChange(selection) => void—Called when the selection changes.
photos{ src: string; alt: string }[]—Photos for the months, repeating as needed.
isDateDisabled(date: Date) => boolean—Days that can’t be picked.
weekStartsOn0 | 110 is Sunday, 1 is Monday.
localestring"en-US"Language for month and day names.

All <div> props.

Requirements

  • lucide-react for icons. React 19 and Tailwind CSS v4. The CLI adds the keyframes.

Customization

  • Create dates with new Date(year, month, day) so they stay on the same local day.

Accessibility

  • The month is a grid: arrow keys move by day and week, Page Up and Page Down move by month.
  • Every day has its full date as its name.

Troubleshooting

Something looks different from the preview.
Components use your project’s theme tokens, so surrounding colours and radius follow your styles.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.
Loading preview

A café dial for choosing a drink, with a cup that shows what goes into it.

Loading preview

A wall plate of rocker switches that light a row of pendant bulbs.

Loading preview

A graphic equalizer panel with faders, LED columns, a response curve and presets.