Phase 1 & 2: full-stack family dashboard scaffold

- pnpm monorepo (apps/client + apps/server)
- Server: Express + node:sqlite with numbered migration runner,
  REST API for all 9 features (members, events, chores, shopping,
  meals, messages, countdowns, photos, settings)
- Client: React 18 + Vite + TypeScript + Tailwind + Framer Motion + Zustand
- Theme system: dark/light + 5 accent colors, CSS custom properties,
  anti-FOUC script, ThemeToggle on every surface
- AppShell: collapsible sidebar, animated route transitions, mobile drawer
- Phase 2 features: Calendar (custom month grid, event chips, add/edit modal),
  Chores (card grid, complete/reset, member filter, streaks),
  Shopping (multi-list tabs, animated check-off, quick-add bar, member assign)
- Family member CRUD with avatar, color picker
- Settings page: theme/accent, photo folder, slideshow, weather, date/time
- Docker: multi-stage Dockerfile, docker-compose.yml, entrypoint with PUID/PGID
- Unraid: CA XML template, CLI install script, UNRAID.md guide
- .gitignore covering node_modules, dist, db files, secrets, build artifacts

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-29 21:56:30 -05:00
parent 6e44883365
commit 35ed5223a0
58 changed files with 6224 additions and 0 deletions

View File

@@ -0,0 +1,3 @@
export default function BoardPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Message Board</h1><p className="text-secondary mt-2">Phase 4</p></div>;
}

View File

@@ -0,0 +1,3 @@
export default function CalendarPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Calendar</h1><p className="text-secondary mt-2">Phase 2</p></div>;
}

View File

@@ -0,0 +1,3 @@
export default function ChoresPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Chores</h1><p className="text-secondary mt-2">Phase 2</p></div>;
}

View File

@@ -0,0 +1,3 @@
export default function CountdownsPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Countdowns</h1><p className="text-secondary mt-2">Phase 4</p></div>;
}

View File

@@ -0,0 +1,8 @@
export default function Dashboard() {
return (
<div className="p-6">
<h1 className="text-2xl font-bold text-primary mb-2">Good morning 👋</h1>
<p className="text-secondary">Your family dashboard is coming together. More widgets arriving in Phase 2.</p>
</div>
);
}

View File

@@ -0,0 +1,3 @@
export default function MealsPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Meal Planner</h1><p className="text-secondary mt-2">Phase 2</p></div>;
}

View File

@@ -0,0 +1,234 @@
import { useState } from 'react';
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { motion, AnimatePresence } from 'framer-motion';
import { Plus, Pencil, Trash2, ArrowLeft } from 'lucide-react';
import { Link } from 'react-router-dom';
import { api, type Member } from '@/lib/api';
import { Button } from '@/components/ui/Button';
import { Input } from '@/components/ui/Input';
import { Modal } from '@/components/ui/Modal';
import { Avatar } from '@/components/ui/Avatar';
const PRESET_COLORS = [
'#6366f1', '#14b8a6', '#f43f5e', '#f59e0b', '#64748b',
'#8b5cf6', '#ec4899', '#10b981', '#f97316', '#06b6d4',
];
interface MemberFormData {
name: string;
color: string;
}
function MemberForm({
initial,
onSubmit,
onCancel,
loading,
}: {
initial?: MemberFormData;
onSubmit: (data: MemberFormData) => void;
onCancel: () => void;
loading: boolean;
}) {
const [name, setName] = useState(initial?.name ?? '');
const [color, setColor] = useState(initial?.color ?? PRESET_COLORS[0]);
return (
<div className="space-y-5">
<Input
label="Name"
value={name}
onChange={(e) => setName(e.target.value)}
placeholder="Family member's name"
autoFocus
/>
<div>
<p className="text-sm font-medium text-secondary mb-3">Color</p>
<div className="flex flex-wrap gap-2.5">
{PRESET_COLORS.map((c) => (
<button
key={c}
onClick={() => setColor(c)}
className="h-8 w-8 rounded-full ring-offset-2 ring-offset-surface transition-all duration-150"
style={{
backgroundColor: c,
boxShadow: color === c ? `0 0 0 2px white, 0 0 0 4px ${c}` : undefined,
}}
aria-label={c}
/>
))}
</div>
<div className="mt-3 flex items-center gap-3">
<input
type="color"
value={color}
onChange={(e) => setColor(e.target.value)}
className="h-8 w-12 cursor-pointer rounded border border-theme bg-transparent"
/>
<span className="text-sm text-muted font-mono">{color}</span>
</div>
</div>
{/* Preview */}
{name && (
<div className="flex items-center gap-3 p-3 rounded-xl bg-surface-raised">
<Avatar name={name} color={color} size="md" />
<span className="font-medium text-primary">{name}</span>
</div>
)}
<div className="flex gap-3 pt-1">
<Button variant="secondary" onClick={onCancel} className="flex-1">Cancel</Button>
<Button onClick={() => onSubmit({ name, color })} loading={loading} disabled={!name.trim()} className="flex-1">
Save
</Button>
</div>
</div>
);
}
export default function MembersPage() {
const qc = useQueryClient();
const [addOpen, setAddOpen] = useState(false);
const [editTarget, setEditTarget] = useState<Member | null>(null);
const [deleteTarget, setDeleteTarget] = useState<Member | null>(null);
const { data: members = [], isLoading } = useQuery<Member[]>({
queryKey: ['members'],
queryFn: () => api.get('/members').then((r) => r.data),
});
const createMutation = useMutation({
mutationFn: (data: MemberFormData) => api.post('/members', data).then((r) => r.data),
onSuccess: () => { qc.invalidateQueries({ queryKey: ['members'] }); setAddOpen(false); },
});
const updateMutation = useMutation({
mutationFn: ({ id, data }: { id: number; data: MemberFormData }) =>
api.put(`/members/${id}`, data).then((r) => r.data),
onSuccess: () => { qc.invalidateQueries({ queryKey: ['members'] }); setEditTarget(null); },
});
const deleteMutation = useMutation({
mutationFn: (id: number) => api.delete(`/members/${id}`),
onSuccess: () => { qc.invalidateQueries({ queryKey: ['members'] }); setDeleteTarget(null); },
});
return (
<div className="p-6 max-w-2xl mx-auto">
{/* Header */}
<div className="flex items-center gap-4 mb-6">
<Link to="/settings" className="p-2 rounded-xl text-secondary hover:bg-surface-raised hover:text-primary transition-colors">
<ArrowLeft size={20} />
</Link>
<div className="flex-1">
<h1 className="text-2xl font-bold text-primary">Family Members</h1>
<p className="text-secondary text-sm">{members.length} member{members.length !== 1 ? 's' : ''}</p>
</div>
<Button onClick={() => setAddOpen(true)}>
<Plus size={16} /> Add Member
</Button>
</div>
{/* Member list */}
{isLoading ? (
<div className="space-y-3">
{[1, 2, 3].map((i) => (
<div key={i} className="h-20 rounded-2xl bg-surface-raised animate-pulse" />
))}
</div>
) : members.length === 0 ? (
<div className="text-center py-16">
<div className="text-5xl mb-4">👨👩👧👦</div>
<p className="text-primary font-semibold text-lg mb-1">No family members yet</p>
<p className="text-secondary text-sm mb-6">Add your family members to assign chores, events, and more.</p>
<Button onClick={() => setAddOpen(true)}>
<Plus size={16} /> Add First Member
</Button>
</div>
) : (
<div className="space-y-3">
<AnimatePresence initial={false}>
{members.map((member) => (
<motion.div
key={member.id}
layout
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, scale: 0.95 }}
className="flex items-center gap-4 p-4 rounded-2xl bg-surface border border-theme hover:border-accent/40 transition-colors group"
>
<Avatar name={member.name} color={member.color} size="lg" />
<div className="flex-1 min-w-0">
<p className="font-semibold text-primary truncate">{member.name}</p>
<p className="text-xs font-mono text-muted">{member.color}</p>
</div>
<div className="flex gap-1 opacity-0 group-hover:opacity-100 transition-opacity">
<button
onClick={() => setEditTarget(member)}
className="p-2 rounded-lg text-secondary hover:bg-surface-raised hover:text-accent transition-colors"
>
<Pencil size={16} />
</button>
<button
onClick={() => setDeleteTarget(member)}
className="p-2 rounded-lg text-secondary hover:bg-surface-raised hover:text-red-500 transition-colors"
>
<Trash2 size={16} />
</button>
</div>
</motion.div>
))}
</AnimatePresence>
</div>
)}
{/* Add modal */}
<Modal open={addOpen} onClose={() => setAddOpen(false)} title="Add Family Member">
<MemberForm
onSubmit={(data) => createMutation.mutate(data)}
onCancel={() => setAddOpen(false)}
loading={createMutation.isPending}
/>
</Modal>
{/* Edit modal */}
<Modal open={!!editTarget} onClose={() => setEditTarget(null)} title="Edit Family Member">
{editTarget && (
<MemberForm
initial={{ name: editTarget.name, color: editTarget.color }}
onSubmit={(data) => updateMutation.mutate({ id: editTarget.id, data })}
onCancel={() => setEditTarget(null)}
loading={updateMutation.isPending}
/>
)}
</Modal>
{/* Delete confirm modal */}
<Modal open={!!deleteTarget} onClose={() => setDeleteTarget(null)} title="Remove Member" size="sm">
{deleteTarget && (
<div className="space-y-4">
<div className="flex items-center gap-3 p-3 rounded-xl bg-surface-raised">
<Avatar name={deleteTarget.name} color={deleteTarget.color} />
<span className="font-medium text-primary">{deleteTarget.name}</span>
</div>
<p className="text-secondary text-sm">
Removing this member won't delete their assigned chores or events those will simply become unassigned.
</p>
<div className="flex gap-3">
<Button variant="secondary" onClick={() => setDeleteTarget(null)} className="flex-1">Cancel</Button>
<Button
variant="danger"
loading={deleteMutation.isPending}
onClick={() => deleteMutation.mutate(deleteTarget.id)}
className="flex-1"
>
Remove
</Button>
</div>
</div>
)}
</Modal>
</div>
);
}

View File

@@ -0,0 +1,3 @@
export default function PhotosPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Photo Slideshow</h1><p className="text-secondary mt-2">Phase 3</p></div>;
}

View File

@@ -0,0 +1,208 @@
import { useEffect, useState } from 'react';
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { Save, Folder, Clock, Image, Cloud, Users } from 'lucide-react';
import { api, type AppSettings } from '@/lib/api';
import { Button } from '@/components/ui/Button';
import { Input } from '@/components/ui/Input';
import { ThemeToggle } from '@/components/ui/ThemeToggle';
import { useThemeStore, ACCENT_TOKENS, type AccentColor } from '@/store/themeStore';
import { clsx } from 'clsx';
import { Link } from 'react-router-dom';
function Section({ title, icon, children }: { title: string; icon: React.ReactNode; children: React.ReactNode }) {
return (
<div className="bg-surface rounded-2xl border border-theme p-6">
<div className="flex items-center gap-3 mb-5">
<span className="text-accent">{icon}</span>
<h2 className="text-base font-semibold text-primary">{title}</h2>
</div>
<div className="space-y-4">{children}</div>
</div>
);
}
export default function SettingsPage() {
const qc = useQueryClient();
const { accent, setAccent } = useThemeStore();
const { data: settings } = useQuery<AppSettings>({
queryKey: ['settings'],
queryFn: () => api.get('/settings').then((r) => r.data),
});
const [form, setForm] = useState<Partial<AppSettings>>({});
useEffect(() => { if (settings) setForm(settings); }, [settings]);
const mutation = useMutation({
mutationFn: (patch: Partial<AppSettings>) => api.patch('/settings', patch).then((r) => r.data),
onSuccess: () => qc.invalidateQueries({ queryKey: ['settings'] }),
});
const set = (key: keyof AppSettings, value: string) => setForm((f) => ({ ...f, [key]: value }));
const save = () => mutation.mutate(form as AppSettings);
return (
<div className="p-6 max-w-3xl mx-auto space-y-6">
<div className="flex items-center justify-between">
<div>
<h1 className="text-2xl font-bold text-primary">Settings</h1>
<p className="text-secondary text-sm mt-1">Configure your family dashboard</p>
</div>
<Button onClick={save} loading={mutation.isPending}>
<Save size={16} /> Save Changes
</Button>
</div>
{/* ── Appearance ─────────────────────────────────────────────── */}
<Section title="Appearance" icon={<Image size={20} />}>
<div>
<p className="text-sm font-medium text-secondary mb-3">Theme Mode</p>
<ThemeToggle showLabel />
</div>
<div>
<p className="text-sm font-medium text-secondary mb-3">Accent Color</p>
<div className="flex gap-3 flex-wrap">
{(Object.keys(ACCENT_TOKENS) as AccentColor[]).map((key) => {
const { base, label } = ACCENT_TOKENS[key];
return (
<button
key={key}
onClick={() => { setAccent(key); set('accent', key); }}
className={clsx(
'flex items-center gap-2 px-4 py-2 rounded-xl border-2 text-sm font-medium transition-all',
accent === key
? 'border-accent text-accent bg-accent-light'
: 'border-theme text-secondary hover:border-accent/50'
)}
>
<span className="h-3.5 w-3.5 rounded-full shrink-0" style={{ backgroundColor: base }} />
{label}
</button>
);
})}
</div>
</div>
</Section>
{/* ── Family Members ─────────────────────────────────────────── */}
<Section title="Family Members" icon={<Users size={20} />}>
<p className="text-sm text-secondary">
Add, edit, or remove family members. Members are used throughout the app to assign chores, events, and shopping items.
</p>
<Link to="/settings/members">
<Button variant="secondary">
<Users size={16} /> Manage Family Members
</Button>
</Link>
</Section>
{/* ── Photo Slideshow ────────────────────────────────────────── */}
<Section title="Photo Slideshow" icon={<Folder size={20} />}>
<Input
label="Photo Folder Path"
value={form.photo_folder ?? ''}
onChange={(e) => set('photo_folder', e.target.value)}
placeholder="C:\Users\YourName\Pictures\Family"
hint="Absolute path to the folder containing your photos. Subfolders are included."
/>
<div className="grid grid-cols-2 gap-4">
<div>
<label className="text-sm font-medium text-secondary block mb-1.5">Transition Speed (ms)</label>
<select
className="w-full rounded-lg border border-theme bg-surface-raised px-3 py-2 text-sm text-primary focus:outline-none focus:ring-2 ring-accent"
value={form.slideshow_speed ?? '6000'}
onChange={(e) => set('slideshow_speed', e.target.value)}
>
{[3000, 5000, 6000, 8000, 10000, 15000].map((v) => (
<option key={v} value={v}>{v / 1000}s</option>
))}
</select>
</div>
<div>
<label className="text-sm font-medium text-secondary block mb-1.5">Photo Order</label>
<select
className="w-full rounded-lg border border-theme bg-surface-raised px-3 py-2 text-sm text-primary focus:outline-none focus:ring-2 ring-accent"
value={form.slideshow_order ?? 'random'}
onChange={(e) => set('slideshow_order', e.target.value)}
>
<option value="random">Random</option>
<option value="sequential">Sequential</option>
<option value="newest">Newest First</option>
</select>
</div>
</div>
<div>
<label className="text-sm font-medium text-secondary block mb-1.5">Idle Timeout (before screensaver)</label>
<select
className="w-full rounded-lg border border-theme bg-surface-raised px-3 py-2 text-sm text-primary focus:outline-none focus:ring-2 ring-accent"
value={form.idle_timeout ?? '120000'}
onChange={(e) => set('idle_timeout', e.target.value)}
>
<option value="60000">1 minute</option>
<option value="120000">2 minutes</option>
<option value="300000">5 minutes</option>
<option value="600000">10 minutes</option>
<option value="0">Disabled</option>
</select>
</div>
</Section>
{/* ── Date & Time ────────────────────────────────────────────── */}
<Section title="Date & Time" icon={<Clock size={20} />}>
<div className="grid grid-cols-2 gap-4">
<div>
<label className="text-sm font-medium text-secondary block mb-1.5">Time Format</label>
<select
className="w-full rounded-lg border border-theme bg-surface-raised px-3 py-2 text-sm text-primary focus:outline-none focus:ring-2 ring-accent"
value={form.time_format ?? '12h'}
onChange={(e) => set('time_format', e.target.value)}
>
<option value="12h">12-hour (3:30 PM)</option>
<option value="24h">24-hour (15:30)</option>
</select>
</div>
<div>
<label className="text-sm font-medium text-secondary block mb-1.5">Date Format</label>
<select
className="w-full rounded-lg border border-theme bg-surface-raised px-3 py-2 text-sm text-primary focus:outline-none focus:ring-2 ring-accent"
value={form.date_format ?? 'MM/DD/YYYY'}
onChange={(e) => set('date_format', e.target.value)}
>
<option value="MM/DD/YYYY">MM/DD/YYYY</option>
<option value="DD/MM/YYYY">DD/MM/YYYY</option>
<option value="YYYY-MM-DD">YYYY-MM-DD</option>
</select>
</div>
</div>
</Section>
{/* ── Weather ────────────────────────────────────────────────── */}
<Section title="Weather Widget" icon={<Cloud size={20} />}>
<Input
label="OpenWeatherMap API Key"
value={form.weather_api_key ?? ''}
onChange={(e) => set('weather_api_key', e.target.value)}
placeholder="Your free API key from openweathermap.org"
type="password"
/>
<Input
label="Location (city name or zip)"
value={form.weather_location ?? ''}
onChange={(e) => set('weather_location', e.target.value)}
placeholder="New York, US"
/>
<div>
<label className="text-sm font-medium text-secondary block mb-1.5">Units</label>
<select
className="w-full rounded-lg border border-theme bg-surface-raised px-3 py-2 text-sm text-primary focus:outline-none focus:ring-2 ring-accent"
value={form.weather_units ?? 'imperial'}
onChange={(e) => set('weather_units', e.target.value)}
>
<option value="imperial">Imperial (°F)</option>
<option value="metric">Metric (°C)</option>
</select>
</div>
</Section>
</div>
);
}

View File

@@ -0,0 +1,3 @@
export default function ShoppingPage() {
return <div className="p-6"><h1 className="text-2xl font-bold text-primary">Shopping</h1><p className="text-secondary mt-2">Phase 2</p></div>;
}