Calendar

Calendar

The /calendar page — month and week views of your family's calendar, synced from Google + any local events you add by hand.

TODO: week view variant

Sources of events

The calendar surface unifies events from:

1. Google Calendar (two-way sync) — any calendar you've enabled in Google-Calendar. Events created or edited in Kinboard are pushed back to Google; edits made on the Google side flow down at the next sync interval. Subject to Google's per-calendar permissions: a read-only subscribed calendar (holidays, sports schedules, etc.) stays read-only in Kinboard too.
2. Local events — added directly in the Kinboard UI without selecting a Google calendar. Lives in public.events with no Google link and never round-trips to Google.
3. Holidays — Google calendars marked with the "holidays" badge get rendered with the 🎉 indicator and slightly different styling.
4. Waste-pickup calendars — Google calendars marked with the "waste pickup" badge are hidden from the calendar view and show up only on the waste widget. Avoids cluttering month view with weekly bin reminders.

Month view

The default. 35-42 cells, one per day in the month. Each day shows:

• The day number (today highlighted with the monthly theme color)
• Up to 3 event chips, color-coded per person
• Holiday indicator if applicable
• Birthday indicator if applicable

Tap a day → day-detail panel slides in showing all events + birthdays + holidays for that date.

Week view

7-column hourly grid for the active week, like a typical calendar app. Useful for time-bound planning. Time-of-day events show as colored blocks; all-day events float at the top.

Per-person colors

Each event is color-coded by the person it's assigned to. Assignment happens in three ways:

1. Whole calendar → one person — set in Google-Calendar per calendar
2. Per-event mapping rule — contains "Emma" / starts_with "Mama:" → assign to Emma. Configured in the same settings page.
3. Manual override — edit a local event and pick the person directly

If no rule matches, the event is "family-wide" (gray accent).

Adding an event

The blue "+ New event" button opens a dialog:

• Title (required)
• All-day toggle
• Start + end (date picker)
• Person assignment (or "family")
• Calendar — pick any of your Google calendars (event will round-trip to Google) or "Local only" (stays inside Kinboard)
• Notes

Events show up immediately for everyone in the family. If you picked a Google calendar, the event lands on Google within a few seconds and the next sync round-trip cements it. Edits and deletes also propagate.

Tap any existing event → edit dialog with the same fields. Delete via the trash icon.

Day-detail panel

Tapping any day in month view (or any block in week view) opens a side panel with:

• Date + day name
• Holiday card if applicable
• Event list for that day, grouped by all-day → timed → ended
• Birthday cards for anyone celebrating that day
• Add-event quick action

The day panel is the main "interaction" surface — month/week views are glance surfaces.

Quick patterns

• "What's on this week" → tap any day in the current week, then arrow through
• "Find an event" → no built-in search yet (v1.2). For now, eyeball it or browse Google Calendar
• "Add a recurring event" → not directly supported in the local-event editor. Add as a recurring event in Google Calendar and it'll sync in.

Holidays

The holidays widget reads German federal holidays (webapp/src/lib/german-holidays.ts) by default. Add a Google Calendar with the "holidays" flag to override or augment with your country's holidays.

Country-aware holiday support is on the v1.1 list — getGermanHolidays will generalize to a holidays/<country-code> directory.

Calendar mapping rule editor

Hidden under Google-Calendar. Useful when:

• One shared family calendar, want each person's events colored differently → use rules to auto-assign by title pattern
• Subscribed to a calendar that mixes events for multiple people (school, sports club) → rules split it

Rules support contains / starts_with / ends_with / regex matching. Test in-place with the Test button before saving.

What's not supported

• Attendees / invites. Google events show their attendees in the day panel as read-only text; you can't RSVP or invite people from Kinboard.
• iCalendar (.ics) feeds — only Google Calendar today. ICS support is on the wishlist.
• Reminders / notifications for upcoming events. Web push is wired up for shopping + tasks; calendar-event notifications planned for v1.1.
• Editing read-only subscribed Google calendars — if Google itself marks the calendar as read-only (someone else's calendar shared with you, public holiday calendars, etc.), Kinboard can't write to it either.

Related

• Google-Calendar — connect Google + per-event mapping rules
• Birthdays — birthdays appear in the calendar; managed separately
• Themes-and-Locales — date formatting per locale