# Calendar Agenda, month, week, month + day, timeline, upcoming or tile. `custom:fluvy-calendar-card` · [Try it live](https://acosta290.github.io/fluvy/?card=calendar) · [All cards](../cards.md#time) The Calendar card, drawn from the example below ## Example ```yaml type: custom:fluvy-calendar-card calendars: - calendar.chores - calendar.family - calendar.ona - calendar.personal - calendar.services first_weekday: monday ``` The picture above, on the demo house: put your own entities in place of its. ## Layouts `variant` chooses the layout. The picture above is `agenda`, the default; each of the others is the example plus the line over it, and opens in the live demo.
variant: month
The Calendar card in its month layout
variant: week
The Calendar card in its week layout
variant: month-day
The Calendar card in its month-day layout
variant: timeline
The Calendar card in its timeline layout
variant: upcoming
The Calendar card in its upcoming layout
variant: tile
The Calendar card in its tile layout
## All options ```yaml type: custom:fluvy-calendar-card calendars: - calendar.chores - calendar.family - calendar.ona - calendar.personal - calendar.services variant: agenda # title: show_icon: auto name_lines: 1 # color: # card_color: # card_opacity: 100 # card_border: true # unavailable: dashed first_weekday: monday ``` ## Options | Option | Default | What it does | | --- | --- | --- | | `variant` | `agenda` | The card’s layout. `agenda` · `month` · `week` · `month-day` (Month and day) · `timeline` · `upcoming` · `tile`. | | `title` | | The title at the top of the card. | | `tile` | `date` | What the tile shows: the date, or the next event. `date` (The date) · `next` (The next event). | | `first_weekday` | `language` | The day the weeks and the months start on. `language` (As the language does) · `today` · `sunday` · `monday` · `tuesday` · `wednesday` · `thursday` · `friday` · `saturday`. | | `days` | | How many days ahead the agenda shows. 1 to 31. | | `start_hour` | | The hour the timeline starts at. 0 to 23. | | `end_hour` | | The hour the timeline ends at. 1 to 24. | | [`calendars`](#calendars) | | The calendars whose events the card shows. A list: [its items](#calendars). |
Its look and its actions, as on every card | Option | Default | What it does | | --- | --- | --- | | `show_icon` | `auto` | Shows the icon, hides it, or lets the card decide. `auto` · `always` · `never`. | | `name_lines` | `1` | Lets the name in the card’s head take two balanced lines where one would cut it; the head is a line taller whatever the name. `1` · `2`. | | `color` | | The card’s colour: its circle, its accents and its tints wear it. Left out, the colour of what it shows. | | `card_color` | | Paints the card’s surface in a colour of your own. | | `card_opacity` | `100` | How solid the card’s surface is, in percent: under 100 the view’s background shows through. Left out, the house’s. 0 % to 100 %, in steps of 5. | | `card_border` | `true` | Whether the card draws its hairline border. Left out, the house’s. | | `unavailable` | `dashed` | How the card looks while its entity is unavailable: dashed, or quiet as when it is off. Left out, the house’s. `dashed` · `quiet` (As when off). | More about them in [Options every card takes](../customising.md#options-every-card-takes).
## Lists ### `calendars` An item is an entity id, or a map with `entity` and any of these fields. | Field | What it does | | --- | --- | | `entity` | The entity the item shows. A `calendar`. | | `name` | The item’s own name, in place of the one the card would give it. | | `tone` | The item’s colour from the palette’s tones. `accent` · `light` · `heat` · `cool` · `dry` · `fan` · `water` · `solar` · `grid` · `media` · `presence` · `armed` · `battery` · `house` · `gas` · `vehicle` (Car) · `neutral` · `ok` (Good) · `warning` · `danger`. | | `color` | The item’s colour, in place of the one the card gives it. | ## Guide The week and the month start on the day `first_weekday` says: a weekday, or `language` (the default: your profile's, else your language's). ```yaml # the week view as the next seven days type: custom:fluvy-calendar-card variant: week first_weekday: today calendars: - calendar.family - calendar.work ``` `first_weekday: today` makes the week strip today and the six days after it ("Next 7 days"). It rolls over at midnight by itself, for a wall dashboard that is never reloaded. A month keeps your week's first day.
Older names the card still reads | Older name | Read as | | --- | --- | | `entities` | `calendars` | | `layout` | `variant` | | `view` | `variant` | | `accent` | `color` |