Redesign UI as light-themed week-grid calendar matching Skylight-style device

- Replace scrolling event list + photo background with a Sun–Sat week grid
  plus a "Next Week" preview column; Prev/Next navigation and per-member filter
- Add [Name] event title prefix convention for color-coded family member cards
  (Ludwig/Dad=blue, Michelle/Mom=pink, Jason=green, Daniel=yellow)
- /api/calendar now accepts ?start=YYYY-MM-DD, returns bucketed week payload
  with member/color metadata; fetches 14 days to populate Next Week column
- Drop rotating background photo and dad joke from the display (endpoints kept)
- Update README with new UI overview, prefix convention, and API docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

static/js/app.js

@@ -2,315 +2,195 @@
 const INTERVALS = {
     TIME: 1000,              // 1 second
     WEATHER: 900000,         // 15 minutes
-    CALENDAR: 300000,        // 5 minutes
-    BACKGROUND: 3600000,     // 60 minutes
-    JOKE: 3600000           // 1 hour
+    CALENDAR: 300000         // 5 minutes
 };
 
+const DAY_LABELS = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+const MONTH_LABELS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+
+let currentWeekStart = startOfWeek(new Date());
+let activeFilter = 'all';
+let filterOptionsBuilt = false;
+let lastWeekData = null;
+
 // Return an OWM icon image tag for a given icon code
 function weatherIcon(code) {
     const src = `https://openweathermap.org/img/wn/${code}@2x.png`;
     return `<img src="${src}" alt="${code}" class="owm-icon">`;
 }
 
-// Initialize the application
-document.addEventListener('DOMContentLoaded', () => {
-    // Start all update functions
-    updateTime();
-    updateWeather();
-    updateCalendar();
-    updateBackground();
-    updateJoke();
-
-    // Set up intervals
-    setInterval(updateTime, INTERVALS.TIME);
-    setInterval(updateWeather, INTERVALS.WEATHER);
-    setInterval(updateCalendar, INTERVALS.CALENDAR);
-    setInterval(updateBackground, INTERVALS.BACKGROUND);
-    setInterval(updateJoke, INTERVALS.JOKE);
-});
-
-// Update time and date
-function updateTime() {
-    const now = new Date();
-
-    // Format time (HH:MM)
-    const hours = String(now.getHours()).padStart(2, '0');
-    const minutes = String(now.getMinutes()).padStart(2, '0');
-    document.getElementById('time').textContent = `${hours}:${minutes}`;
-
-    // Format date (Day, Month Date)
-    const options = { weekday: 'long', month: 'long', day: 'numeric' };
-    const dateString = now.toLocaleDateString('en-NZ', options);
-    document.getElementById('date').textContent = dateString;
+// Sunday-starting week for a given date
+function startOfWeek(date) {
+    const d = new Date(date);
+    d.setHours(0, 0, 0, 0);
+    d.setDate(d.getDate() - d.getDay());
+    return d;
 }
 
-// Fetch and update weather
+function toISODate(date) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+
+function formatRangeLabel(startISO, endISO) {
+    const start = new Date(startISO + 'T00:00:00');
+    const end = new Date(endISO + 'T00:00:00');
+    const startLabel = `${MONTH_LABELS[start.getMonth()]} ${start.getDate()}`;
+    const endLabel = end.getMonth() === start.getMonth() ? `${end.getDate()}` : `${MONTH_LABELS[end.getMonth()]} ${end.getDate()}`;
+    return `${startLabel}-${endLabel}`;
+}
+
+// Initialize the application
+document.addEventListener('DOMContentLoaded', () => {
+    updateTime();
+    updateWeather();
+    fetchCalendar();
+
+    document.getElementById('prev-week').addEventListener('click', () => shiftWeek(-7));
+    document.getElementById('next-week').addEventListener('click', () => shiftWeek(7));
+    document.getElementById('member-filter').addEventListener('change', (e) => {
+        activeFilter = e.target.value;
+        if (lastWeekData) renderWeek(lastWeekData);
+    });
+    document.getElementById('add-btn').addEventListener('click', showAddToast);
+
+    setInterval(updateTime, INTERVALS.TIME);
+    setInterval(updateWeather, INTERVALS.WEATHER);
+    setInterval(fetchCalendar, INTERVALS.CALENDAR);
+});
+
+function shiftWeek(days) {
+    currentWeekStart = new Date(currentWeekStart);
+    currentWeekStart.setDate(currentWeekStart.getDate() + days);
+    fetchCalendar();
+}
+
+// Update time and date in the header
+function updateTime() {
+    const now = new Date();
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    document.getElementById('header-time').textContent = `${hours}:${minutes}`;
+    document.getElementById('header-date').textContent = `${MONTH_LABELS[now.getMonth()]} ${String(now.getDate()).padStart(2, '0')}`;
+}
+
+// Fetch and update weather chip
 async function updateWeather() {
     try {
         const response = await fetch('/api/weather');
         if (!response.ok) throw new Error('Weather fetch failed');
 
         const data = await response.json();
+        if (data.error || !data.current) return;
 
-        if (data.error) {
-            console.error('Weather error:', data.error);
-            return;
-        }
-
-        // Update current weather in header
-        const { current, forecast } = data;
-
-        document.getElementById('current-temp').textContent = `${current.temp}°`;
-        document.getElementById('weather-icon').innerHTML = weatherIcon(current.icon);
-
-        // Update 3-day forecast in header
-        const headerForecast = document.getElementById('header-forecast');
-        headerForecast.innerHTML = '';
-
-        forecast.forEach(day => {
-            const dayElement = document.createElement('div');
-            dayElement.className = 'forecast-item';
-            dayElement.innerHTML = `
-                <div class="weather-label">${day.date}</div>
-                <div class="forecast-icon">${weatherIcon(day.icon)}</div>
-                <div class="forecast-temps">
-                    <span class="high">${day.temp_max}°</span>
-                    <span class="low">${day.temp_min}°</span>
-                </div>
-            `;
-            headerForecast.appendChild(dayElement);
-        });
-
+        document.getElementById('current-temp').textContent = `${data.current.temp}°`;
+        document.getElementById('weather-icon').innerHTML = weatherIcon(data.current.icon);
     } catch (error) {
         console.error('Error updating weather:', error);
     }
 }
 
-// Fetch and update calendar events
-async function updateCalendar() {
+// Fetch the current week's calendar data and render it
+async function fetchCalendar() {
     try {
-        const response = await fetch('/api/calendar');
+        const response = await fetch(`/api/calendar?start=${toISODate(currentWeekStart)}`);
         if (!response.ok) throw new Error('Calendar fetch failed');
 
-        const events = await response.json();
-
-        if (events.error) {
-            console.error('Calendar error:', events.error);
-            return;
-        }
-
-        const eventsContainer = document.getElementById('calendar-events');
-
-        if (!events || events.length === 0) {
-            eventsContainer.innerHTML = '<div class="event-placeholder">No upcoming events</div>';
-            return;
-        }
-
-        // Group events by day
-        const eventsByDay = {};
-        const today = new Date();
-        today.setHours(0, 0, 0, 0);
-
-        // Create 5 days (today + 4 more)
-        for (let i = 0; i < 5; i++) {
-            const date = new Date(today);
-            date.setDate(today.getDate() + i);
-            const dateKey = date.toISOString().split('T')[0];
-            eventsByDay[dateKey] = {
-                date: date,
-                events: []
-            };
-        }
-
-        // Group events by their date (including multi-day events)
-        events.forEach(event => {
-            const eventStart = new Date(event.start);
-            const eventEnd = new Date(event.end);
-            eventStart.setHours(0, 0, 0, 0);
-            eventEnd.setHours(0, 0, 0, 0);
-
-            // Check each day in our 5-day view
-            Object.keys(eventsByDay).forEach(dateKey => {
-                const dayDate = new Date(eventsByDay[dateKey].date);
-                dayDate.setHours(0, 0, 0, 0);
-
-                // Include event if this day falls within the event's duration
-                if (dayDate >= eventStart && dayDate <= eventEnd) {
-                    eventsByDay[dateKey].events.push(event);
-                }
-            });
-        });
-
-        // Render events grouped by day
-        eventsContainer.innerHTML = '';
-
-        Object.keys(eventsByDay).sort().forEach(dateKey => {
-            const dayData = eventsByDay[dateKey];
-            const dayElement = document.createElement('div');
-            dayElement.className = 'day-group';
-
-            // Format day header
-            const dayDate = dayData.date;
-            const isToday = dayDate.toDateString() === new Date().toDateString();
-            const dayName = isToday ? 'Today' : dayDate.toLocaleDateString('en-NZ', { weekday: 'long' });
-            const dateStr = dayDate.toLocaleDateString('en-NZ', { day: 'numeric', month: 'short' });
-
-            dayElement.innerHTML = `
-                <div class="day-header">
-                    <span class="day-name">${dayName}</span>
-                    <span class="day-date">${dateStr}</span>
-                </div>
-                <div class="day-events"></div>
-            `;
-
-            const dayEventsContainer = dayElement.querySelector('.day-events');
-
-            if (dayData.events.length === 0) {
-                dayEventsContainer.innerHTML = '<div class="no-events">No events</div>';
-            } else {
-                dayData.events.forEach(event => {
-                    const eventElement = document.createElement('div');
-                    eventElement.className = 'event';
-
-                    const startTime = new Date(event.start);
-                    const endTime = new Date(event.end);
-
-                    // Check if it's an all-day event (time is 00:00)
-                    const isAllDay = startTime.getHours() === 0 && startTime.getMinutes() === 0
-                                   && endTime.getHours() === 0 && endTime.getMinutes() === 0;
-
-                    let timeString;
-                    if (isAllDay) {
-                        timeString = 'All day';
-                    } else {
-                        timeString = startTime.toLocaleTimeString('en-NZ', { hour: '2-digit', minute: '2-digit' });
-                    }
-
-                    eventElement.innerHTML = `
-                        <div class="event-time">${timeString}</div>
-                        <div class="event-title">${event.title}</div>
-                        ${event.location ? `<div class="event-location">📍 ${event.location}</div>` : ''}
-                    `;
-
-                    dayEventsContainer.appendChild(eventElement);
-                });
-            }
-
-            eventsContainer.appendChild(dayElement);
-        });
+        const data = await response.json();
+        lastWeekData = data;
 
+        document.getElementById('week-range').textContent = formatRangeLabel(data.week_start, data.week_end);
+        buildFilterOptions(data.members);
+        renderWeek(data);
     } catch (error) {
         console.error('Error updating calendar:', error);
+        document.getElementById('week-grid').innerHTML = '<div class="event-placeholder">Unable to load calendar</div>';
     }
 }
 
-// Calculate brightness of an image
-function calculateImageBrightness(imageSrc, callback) {
-    const img = new Image();
-    img.crossOrigin = 'Anonymous';
-
-    img.onload = () => {
-        // Create a canvas to analyze the image
-        const canvas = document.createElement('canvas');
-        const ctx = canvas.getContext('2d');
-
-        // Use a smaller size for faster processing
-        canvas.width = 100;
-        canvas.height = 100;
-
-        // Draw the image scaled down
-        ctx.drawImage(img, 0, 0, 100, 100);
-
-        // Get image data
-        const imageData = ctx.getImageData(0, 0, 100, 100);
-        const data = imageData.data;
-
-        // Calculate average brightness
-        let totalBrightness = 0;
-        const pixelCount = data.length / 4;
-
-        for (let i = 0; i < data.length; i += 4) {
-            const r = data[i];
-            const g = data[i + 1];
-            const b = data[i + 2];
-
-            // Calculate perceived brightness (using luminance formula)
-            const brightness = (0.299 * r + 0.587 * g + 0.114 * b);
-            totalBrightness += brightness;
-        }
-
-        const avgBrightness = totalBrightness / pixelCount;
-
-        // Return brightness value (0-255)
-        callback(avgBrightness);
-    };
-
-    img.onerror = () => {
-        console.error('Error loading image for brightness analysis');
-        // Default to dark background if error
-        callback(100);
-    };
-
-    img.src = imageSrc;
+function buildFilterOptions(members) {
+    if (filterOptionsBuilt || !members) return;
+    const select = document.getElementById('member-filter');
+    members.forEach(member => {
+        const option = document.createElement('option');
+        option.value = member.key;
+        option.textContent = member.name;
+        select.appendChild(option);
+    });
+    filterOptionsBuilt = true;
 }
 
-// Update background image
-async function updateBackground() {
-    try {
-        const response = await fetch('/api/background');
-        if (!response.ok) throw new Error('Background fetch failed');
+function filterEvents(events) {
+    if (activeFilter === 'all') return events;
+    return events.filter(e => e.member === activeFilter);
+}
 
-        const data = await response.json();
-        const backgroundElement = document.getElementById('background');
+function formatEventTime(event) {
+    const start = new Date(event.start);
+    const end = new Date(event.end);
+    const isAllDay = start.getHours() === 0 && start.getMinutes() === 0 && end.getHours() === 0 && end.getMinutes() === 0;
+    if (isAllDay) return 'All day';
+    return start.toLocaleTimeString('en-NZ', { hour: '2-digit', minute: '2-digit' });
+}
 
-        if (data.image) {
-            // Preload image to avoid flicker
-            const img = new Image();
-            img.onload = () => {
-                backgroundElement.style.backgroundImage = `url('${data.image}')`;
+function eventCardHTML(event) {
+    return `
+        <div class="event-card" style="background:${event.bg}; border-left-color:${event.color};">
+            <div class="event-time">${formatEventTime(event)}</div>
+            <div class="event-title">${event.title}</div>
+            <div class="event-member">${event.member_name}</div>
+        </div>
+    `;
+}
 
-                // Analyze brightness and adjust text color
-                calculateImageBrightness(data.image, (brightness) => {
-                    // Threshold: 128 is middle brightness
-                    // If brightness > 140, use dark text (light background)
-                    // If brightness <= 140, use white text (dark background)
-                    if (brightness > 140) {
-                        document.body.classList.remove('dark-bg');
-                        document.body.classList.add('light-bg');
-                    } else {
-                        document.body.classList.remove('light-bg');
-                        document.body.classList.add('dark-bg');
-                    }
-                });
-            };
-            img.src = data.image;
-        } else if (data.color) {
-            backgroundElement.style.backgroundColor = data.color;
-            backgroundElement.style.backgroundImage = 'none';
-            // Assume solid colors are dark
-            document.body.classList.remove('light-bg');
-            document.body.classList.add('dark-bg');
-        }
+function renderWeek(data) {
+    const grid = document.getElementById('week-grid');
+    grid.innerHTML = '';
 
-    } catch (error) {
-        console.error('Error updating background:', error);
-    }
-}
-
-// Fetch and update dad joke
-async function updateJoke() {
-    try {
-        const response = await fetch('/api/joke');
-        if (!response.ok) throw new Error('Joke fetch failed');
-
-        const data = await response.json();
-
-        if (data.joke) {
-            document.getElementById('joke').textContent = data.joke;
-        }
-
-    } catch (error) {
-        console.error('Error updating joke:', error);
+    const todayISO = toISODate(new Date());
+
+    data.days.forEach(day => {
+        const dayDate = new Date(day.date + 'T00:00:00');
+        const events = filterEvents(day.events);
+
+        const column = document.createElement('div');
+        column.className = 'day-column' + (day.date === todayISO ? ' is-today' : '');
+        column.innerHTML = `
+            <div class="day-header">
+                <div class="day-name">${DAY_LABELS[dayDate.getDay()]}</div>
+                <div class="day-number">${dayDate.getDate()}</div>
+                <div class="day-count">${events.length} event${events.length === 1 ? '' : 's'}</div>
+            </div>
+            <div class="day-events">
+                ${events.map(eventCardHTML).join('') || ''}
+            </div>
+        `;
+        grid.appendChild(column);
+    });
+
+    const nextWeekEvents = filterEvents(data.next_week.events);
+    const nextColumn = document.createElement('div');
+    nextColumn.className = 'next-week-column';
+    nextColumn.innerHTML = `
+        <div class="next-week-title">Next Week</div>
+        <div class="next-week-range">${formatRangeLabel(data.next_week.start, data.next_week.end)}</div>
+        <div class="next-week-count">${data.next_week.count} event${data.next_week.count === 1 ? '' : 's'}</div>
+    `;
+    nextColumn.addEventListener('click', () => shiftWeek(7));
+    grid.appendChild(nextColumn);
+}
+
+function showAddToast() {
+    let toast = document.querySelector('.add-toast');
+    if (!toast) {
+        toast = document.createElement('div');
+        toast.className = 'add-toast';
+        toast.textContent = 'This display is read-only — add events directly in Google Calendar.';
+        document.body.appendChild(toast);
     }
+    toast.classList.add('visible');
+    clearTimeout(showAddToast._timer);
+    showAddToast._timer = setTimeout(() => toast.classList.remove('visible'), 3000);
 }