🍨 Scoop & Joy – Artisan Ice Cream Parlour Website

A vibrant, highly interactive web application for an artisan ice cream parlour built with Next.js (App Router), TypeScript, Tailwind CSS, and Framer Motion.

---

✨ Features

• 🎡 3D 360° Cylindrical Rotating Menu: Interactive virtual cylinder with mouse drag, touch swipe, and snap-to-front physics.
• 🎨 Build Your Own Sundae Studio: Live graphical scoop stacking, waffle vessels, warm drizzles, crunch toppings, and "Surprise Me" generator.
• 🪵 4-Scoop Tasting Flight Paddle: Wooden parlour paddle builder with curated pairings and waffle crisps for Rs. 950.
• 🎪 Vintage Ice Cream Cart Catering: Event booking calculator with 3 package tiers and instant WhatsApp inquiry.
• 🛋️ Table Reservation System: Velvet Lounge, Garden Patio, and Scoop Bar booking with instant confirmation references.
• 📱 1-Tap WhatsApp Checkout: Auto-formatted order receipts sent directly to the parlour.
• 💳 Stripe Checkout Integration: Online card payment support with fallback demo testing.
• 🇱🇰 Sri Lankan Rupee (LKR / Rs.): Realistic pricing throughout the entire application.
• 🎉 Celebration Confetti & Particle Effects: Satisfying delight micro-interactions on checkouts and bookings.
• 📸 Authentic Parlour Gallery: Curated gelato counter, parlour seating, and terrace photos with lightbox viewer.

---

🚀 Quick Start

1. Install dependencies

npm install

2. Copy environment file

cp .env.example .env.local

3. Run development server

npm run dev

Open http://localhost:3000 to view the application.

---

📁 Project Structure

src/
├── app/
│   ├── page.tsx              → Homepage (3D Carousel, Sundae Studio, Tasting Flight, Catering)
│   ├── menu/page.tsx         → 360° Menu & Filter catalog
│   ├── menu/[slug]/page.tsx  → Individual flavor detail page
│   ├── custom-sundae/        → Dedicated Sundae Studio builder
│   ├── tasting-flight/       → Dedicated 4-Scoop Tasting Flight builder
│   ├── catering/             → Dedicated Ice Cream Cart Event Catering page
│   ├── book-table/           → Dedicated Table Reservation page
│   ├── order/page.tsx        → Cart, WhatsApp Order, & Stripe Checkout
│   ├── order/success/        → Payment & Order Confirmation page
│   └── actions/              → Server actions (Stripe session creation)
├── components/               → Interactive UI components
└── lib/
    ├── cart.tsx              → Cart context with localStorage persistence
    ├── data.ts               → Artisan flavors & authentic parlour photos
    ├── format.ts             → Sri Lankan Rupee (LKR) formatting helper
    └── stripe.ts             → Stripe payment client

---

⚡ Deployment on Vercel

1. Push this repository to GitHub.
2. Import the project into Vercel.
3. Set environment variables if using live Stripe payments (STRIPE_SECRET_KEY, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, NEXT_PUBLIC_APP_URL).
4. Deploy!