🎁 Kisses for Kyle Gift Registry

This repository contains the source code for the Kisses for Kyle Gift registry platform that powers the annual Kisses for Kyle holiday gift drive. The Kisses for Kyle Foundation offers a variety of services to families fighting childhood cancer in the Delaware Valley.

Tech Stack

• Framework: TanStack Start + React
• Build Tool: Vite
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: shadcn/ui, Radix UI
• Data Fetching: TanStack Query
• Routing: TanStack Router
• Schema Validation: Zod
• BaaS: Firebase

Directory Structure

kfk-gift-registry/
├── app/          # TanStack Start web application (React, Vite)
├── common/       # Shared TypeScript types and utilities
├── functions/    # Firebase Cloud Functions
├── firebase.json # Firebase project and emulator configuration
└── package.json  # Root package.json with workspace-level scripts

Running Locally

Important

Prerequisites: Node.js v24 and pnpm installed, plus the Firebase CLI (pnpm i -g firebase-tools).

1. Install dependencies:

   pnpm install

2. Build the shared common package (required before first run):

   pnpm --filter common run build

3. Start the development environment:

   pnpm dev

   This launches the Firebase emulators (Auth, Firestore, Functions, Storage) and the TanStack Start dev server via the App Hosting emulator. The app will be available at http://localhost:5002 and the Firebase Emulator UI at http://localhost:4000.

Meet the Team

🧭 Product Managers

Vishesh Khare

Tarun Kommuri

🛠 Tech Leads

Arnav Gupta

Ramy Kaddouri

🎨 Designers

Zayneb Omer

Najma Karissa Arfa

💻 Engineers

Akhila Pasupunuri	Dennis Huynh	Edward Song
Maggie McAndrew	Nadia Meyerovich	Ori Marx
Nazeer Ahmed

---

Points of Contact

Name	Role	Email
Ramy Kaddouri	Tech Lead	rkaddour@terpmail.umd.edu
Arnav Gupta	Tech Lead	agupta67@terpmail.umd.edu