📄 README.md 1,914 bytes Apr 28, 2026 📋 Raw

HoffDesk Family Dashboard

iPad-optimized family dashboard for the HoffDesk ecosystem. Phase 6/7 Bridge implementation.

Features

  • Today View: Current events, urgent items, weather, system health
  • Week View: Weekly calendar overview, maintenance due
  • Documents View: Recent document processing, quick actions
  • Family View: Per-member filtered view with stats

Tech Stack

  • Next.js 16 + React 19
  • TypeScript
  • Tailwind CSS v4
  • WebSocket for real-time updates
  • Mock API for development

Development

# Install dependencies
npm install

# Run with mock data (no backend needed)
npm run dev:mock

# Run with real API (requires backend)
npm run dev

# Build for production
npm run build

iPad Optimization

  • Minimum tap target: 44pt
  • Touch-first design (no hover states)
  • 1024×768 minimum viewport
  • Card-based layout
  • Real-time updates via WebSocket or polling fallback

API Integration

The dashboard connects to Socrates' backend API:

  • GET /api/v1/briefing - Daily briefing data
  • GET /api/v1/events - Events list
  • GET /api/v1/weather - Weather data
  • GET /api/v1/health - System health
  • GET /api/v1/maintenance - Maintenance items
  • GET /api/v1/documents - Recent documents
  • WebSocket /ws/events - Real-time updates

Design Tokens

See shared/design-tokens/ipad-layout.json for layout constants.

Auth

  • Session cookie-based authentication
  • CSRF protection
  • Family user roles: admin, parent, child, viewer
  • Login redirects to /family/login/

Project Structure

src/
  app/              # Next.js app router
  components/
    ui/             # Reusable UI components
    views/          # View-specific components (Today, Week, etc.)
  hooks/            # Custom React hooks
  lib/              # Utilities and API
  mocks/            # Mock data for development
  types/            # TypeScript type definitions
← Back