next-wedding-generator

v3.1.2

Published

2 months ago

A comprehensive AI-powered wedding website generator based on Next.js, Firebase, and Gemini AI.

Downloads

0High
0Medium
0Low

titas_mallick

wedding wedding-website generator cli scaffold ai gemini nextjs firebase invitation guestbook

💍 Wedding Website Generator v3.0 (AI-Powered)

The ultimate digital companion for your special day. Scaffold, personalize, and deploy a feature-rich wedding application in minutes.

🚀 Phase 1: Rapid Generation

Initialize Your Project

Run the command below to start the interactive CLI:

npx next-wedding-generator

CLI Prompt Reference

Answer the prompts to pre-configure your site's identity:

🛠️ Phase 2: System Infrastructure

1. Environment Configuration

A structured template is provided in .env.example. Duplicate this to .env.local and populate the values.

2. Firebase (Database & Auth)

Create a project at Firebase Console.
Authentication: Enable "Email/Password".
Firestore: Create a database in "Production Mode".
Admin SDK: Go to Project Settings > Service Accounts > Generate New Private Key. Use these values for FIREBASE_ADMIN env vars.

2. Firestore Security Rules

Deploy these rules in the Firebase console to ensure data integrity:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /wishes/{wishId} { allow read, write: if true; }
    match /song_requests/{requestId} { allow read, write: if true; }
    match /guestbook/{entryId} { allow read, write: if true; }
    match /rsvps/{rsvpId} { allow read, write: if true; }
    match /email-reminders/{reminderId} { allow read: if true; allow write: if request.auth != null; }
    match /{document=**} { allow read: if true; allow write: if request.auth != null; }
  }
}

3. Media & Automation

Cloudinary: Create an "Unsigned" upload preset named wedding.
Resend: Generate an API key for automated email reminders.
Google Gemini: Get an API key from Google AI Studio.

🎨 Phase 3: Theming & Personalization

1. Visual Theming (Tailwind)

The site's colors are centralized in tailwind.config.js. You can change the primary wedding palette here:

// tailwind.config.js
colors: {
  wedding: {
    pink: {
      500: '#ec4899', // Change this to your primary color
    },
    gold: {
      400: '#d99e43', // Change this to your accent color
    }
  }
}

2. Asset Mapping (`/public/`)

Replace placeholders with your own media. Maintain exact filenames.

| File | Context | | :--- | :--- | | bride.jpg | Main Bride portrait (used in /couple). | | groom.jpg | Main Groom portrait (used in /couple). | | qr.png | Your UPI QR code. | | /Images/19.jpg - 22.jpg | Specific timeline milestones. | | /Images/Patipatra.jpeg | Date-fixing ceremony photo. | | /Images/*.jpg | Bulk Upload: Any extra images here auto-populate the masonry gallery. |

💻 Phase 4: Code-Level Customization

1. Modifying the "Our Story" Section

The narrative is located in components/OurStory.tsx. It uses standard React/Tailwind. Edit the <p> tags to write your own journey.

2. Adding/Removing Navigation Items

Update config/site.ts to add new routes or hide existing ones from the navbar and mobile menu.

3. Tweaking AI Bot Behavior

Go to components/ConciergeBot.tsx and find the systemInstruction variable. You can change the bot's "personality" or add more specific wedding facts.

🎮 Phase 5: Admin & Management

Guest Management Dashboard (`/invitation/maker`)

Login Secret: To log in as admin, scroll to the footer and click the small "Celebrate" heart icon next to the author's name. This will trigger the login modal.
Guest List: Create unique invitation IDs.
Personalized Links: Give every family a unique URL: yoursite.com/invitation/[guest-id].
RSVP Tracking: Live view of attendance and meal choices.

OBS Live Overlay (`/updates/overlay`)

Use this route as a "Browser Source" in OBS for your venue screens:

Real-time News: Scroling updates posted via /updates/maker.
Clock: Synchronized event time.
Background: Chroma-key green for transparency.

🚀 Phase 6: Deployment

Vercel (Recommended)

Push your code to GitHub.
Import project to Vercel.
Add all variables from .env.local to Vercel Environment Variables.

Automated Guest Reminders

Set up a Cron Job (Vercel or GitHub Actions) to trigger:

URL: YOUR_SITE/api/email-reminders
Method: GET
Header: Authorization: Bearer YOUR_CRON_SECRET
Cron: 0 10 10-26 1 * (10 AM daily during Jan).

✨ New Interactive Features (v3.1)

📸 AI Face Recognition (Search by Selfie)

Guests can now find all photos they appear in across the entire guestbook by simply uploading a selfie. This feature uses client-side AI detection and vector matching for privacy and speed.

Route: /guestbook/search
Requires: Models in /public/models (scaffolded automatically).

🎁 Collaborative Gift Registry

A modern gifting platform where guests can contribute to specific items for the couple's new home.

Group Gifting: Support for multiple guests to contribute to high-value items.
Management: Admin dashboard at /registry/maker to manage gift items and track contributions.
Personalized Access: Guests access their registry view via /registry/[guest-slug].

⚡ Bulk Media Upload

Admin tool to rapidly populate the guestbook gallery with official event photography.

Route: /guestbook/bulkupload (Admin only).

🖼️ Personalized OG Images

Dynamic Open Graph images are now generated for each guest invitation (/api/og?slug=...). These cards display the guest's name and are used when sharing invitation links on social media (WhatsApp, Facebook, etc.).

🛡️ Security Access (SayCode)

A client-side security overlay (SayCode) has been implemented to protect public inputs (RSVP, Wishes, etc.) from automated bots during the event week.

Trigger: Active only between Jan 21 - Jan 27.
Dismissal: Users must answer a simple question (Answer: "10") or dismiss the overlay to interact with the site.
Persistence: Dismissal is saved in local storage.

📜 License

MIT License. Built with ❤️ for the community.