@titas_mallick/wedding-site-gen 1.0.4 → 1.0.6

package/README.md

@@ -74,6 +74,77 @@ npx @titas_mallick/wedding-site-gen
   - *Logic*: Uses a `setInterval` to calculate time until the `weddingStart` date.
 - **`OurStory.tsx`**: The timeline component showing the couple's history.
 
+## 🧠 Deep-Dive: How it Works
+
+### 1. AI Wedding Concierge (`ConciergeBot.tsx`)
+The floating assistant uses **Google Gemini 2.5-flash**. 
+- **Personality**: Defined in the `systemInstruction` constant. It's programmed to be a warm, respectful Indian wedding host.
+- **Customization**: To update facts (like venue changes), simply edit the `Key Info` section inside the `systemInstruction` in `components/ConciergeBot.tsx`.
+
+### 2. Personalized Invitations (`/app/invitation/[slug]`)
+This route handles dynamic guest experiences.
+- **Dynamic Content**: Based on the `slug` (guest ID), it fetches personalized data from Firestore.
+- **Smart Bengali Translation**: Uses Gemini to translate invitation details into formal Bengali when the user clicks "বাংলায় দেখুন".
+
+### 3. Digital Guestbook (`/app/guestbook`)
+- **Image Processing**: Before uploading, photos are client-side resized and compressed (JPEG 70% quality) to ensure fast uploads even on mobile networks.
+- **Storage**: Images go to Cloudinary, and the resulting URL is saved to Firestore.
+
+### 4. Sentiment Wall (`/app/sagun`)
+- **Collective Blessing**: When guests leave wishes, Gemini periodically summarizes the latest messages into a single "poetic paragraph" that updates live on the "Sentiment Wall."
+
+---
+
+## 📊 Database Structure (Firestore)
+
+To make the site functional, create these collections in Firestore:
+
+### `invitation` (Collection)
+Each document ID should be a unique `slug` (e.g., `rahul-wedding`).
+```json
+{
+  "name": "Rahul & Priya",
+  "invitedGuests": 2,
+  "relation": "Close Friend",
+  "familySide": "groom",
+  "invitedFor": ["wedding", "reception"]
+}
+```
+
+### `rsvps` (Collection)
+Automatically populated when guests confirm attendance.
+```json
+{
+  "guestId": "rahul-wedding",
+  "attending": "yes",
+  "guests": 2,
+  "food": "non-veg",
+  "note": "Looking forward to it!",
+  "timestamp": "serverTime"
+}
+```
+
+### `guestbook` & `wishes` (Collections)
+Store guest memories and text blessings respectively.
+
+### 🔒 Recommended Firestore Rules
+Paste these into your Firebase Console to secure your data (also available in `firestore.rules`):
+```javascript
+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 /{document=**} {
+      allow read: if true;
+      allow write: if request.auth != null;
+    }
+  }
+}
+```
+
 ---
 
 ## 🎨 Customization & Development
@@ -108,6 +179,7 @@ This project uses **Tailwind CSS** and **HeroUI**.
 5. Copy the `firebaseConfig` values into your `.env.local`:
    - `NEXT_PUBLIC_APIKEY`, `NEXT_PUBLIC_AUTHDOMAIN`, `NEXT_PUBLIC_PROJECTID`, etc.
 6. **Admin SDK**: Go to **Project Settings > Service accounts**, click "Generate new private key", and use those values for the `FIREBASE_ADMIN_*` variables in `.env.local`.
+7. **Security Rules**: Go to the **Rules** tab in Firestore and paste the contents of `firestore.rules` found in this project.
 
 ### 2. Google Gemini (AI Concierge)
 1. Go to the [Google AI Studio](https://aistudio.google.com/).

package/cli.mjs

@@ -112,7 +112,7 @@ export default adminCred;
 
         // Only process text files for replacements
         const ext = path.extname(srcPath).toLowerCase();
-        const textExtensions = ['.ts', '.tsx', '.js', '.jsx', '.json', '.md', '.css', '.html'];
+        const textExtensions = ['.ts', '.tsx', '.js', '.jsx', '.json', '.md', '.css', '.html', '.rules'];
         
         if (textExtensions.includes(ext)) {
           let content = await fs.readFile(srcPath, 'utf8');

package/firestore.rules

@@ -0,0 +1,26 @@
+rules_version = '2';
+service cloud.firestore {
+  match /databases/{database}/documents {
+    // Wishes collection - anyone can read and write
+    match /wishes/{wishId} {
+      allow read, write: if true;
+    }
+    // Song requests collection - anyone can read and write
+    match /song_requests/{requestId} {
+      allow read, write: if true;
+    }
+    // Guestbook collection - anyone can read and write
+    match /guestbook/{entryId} {
+      allow read, write: if true;
+    }
+    // RSVPs collection - anyone can read and write
+    match /rsvps/{rsvpId} {
+      allow read, write: if true;
+    }
+    // All other documents - read public, write authenticated only
+    match /{document=**} {
+      allow read: if true;
+      allow write: if request.auth != null;
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titas_mallick/wedding-site-gen",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "bin": {
     "wedding-gen": "./cli.mjs"
   },