🄘 Family Potluck Planner

A fun and interactive potluck planning app where family members can collaborate on meal planning and coordinate who brings what!

Features

  • šŸ‘„ Simple name-based sign-in (no passwords needed for family use)
  • šŸ½ļø Add dishes and supplies needed for the potluck
  • āœļø Anyone can edit any item (name, category, description)
  • šŸ™‹ā€ā™€ļø Claim items to bring with your name
  • šŸ—‘ļø Anyone can delete any item
  • šŸ“ Add and edit general notes for planning and coordination (anyone can edit)
  • šŸ“± Mobile-friendly responsive design
  • šŸŽØ Fun, colorful interface with food emojis
  • āš™ļø Admin panel for data management

Project Structure

ā”œā”€ā”€ backend/
│   ā”œā”€ā”€ database/
│   │   ā”œā”€ā”€ migrations.ts    # Database schema
│   │   └── queries.ts       # Database operations
│   ā”œā”€ā”€ routes/
│   │   └── api.ts          # API endpoints
│   └── index.ts            # Main server entry point
ā”œā”€ā”€ frontend/
│   ā”œā”€ā”€ components/
│   │   ā”œā”€ā”€ App.tsx         # Main app component
│   │   ā”œā”€ā”€ ItemCard.tsx    # Individual item display with edit/delete
│   │   ā”œā”€ā”€ AddItemForm.tsx # Form to add new items
│   │   ā”œā”€ā”€ NotesSection.tsx # Notes display and editing
│   │   └── AdminPanel.tsx  # Admin controls for data management
│   ā”œā”€ā”€ index.html          # Main HTML template
│   ā”œā”€ā”€ index.tsx           # Frontend entry point
│   └── style.css           # Custom styles
└── shared/
    └── types.ts            # Shared TypeScript types

Usage

  1. Visit the app URL
  2. Enter your name to join the potluck
  3. Add dishes or supplies needed
  4. Add general notes for planning and coordination
  5. Claim items you want to bring
  6. Edit or delete any items and notes using the āœļø and šŸ—‘ļø buttons (anyone can edit anything)
  7. Share the link with family members!

Admin Features

Click the āš™ļø gear icon in the bottom-right corner to access admin functions:

  • Clear All Items: Remove all dishes/supplies (keeps users and notes)
  • Clear All Users: Remove all family members (keeps items and notes)
  • Clear All Notes: Remove all general notes (keeps items and users)
  • Clear Everything: Complete reset of the potluck

āš ļø Warning: Admin actions cannot be undone!

Tech Stack

  • Backend: Hono + SQLite
  • Frontend: React + TailwindCSS
  • Storage: Val Town SQLite
  • Styling: TailwindCSS with custom food-themed colors