@titas_mallick/wedding-site-gen 2.0.4 โ†’ 2.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/ARTICLE.md +80 -0
  2. package/README.md +3 -0
  3. package/package.json +9 -1
package/ARTICLE.md ADDED
@@ -0,0 +1,80 @@
1
+ # ๐Ÿ’ Say "I Do" to Automation: Building an AI-Powered Wedding Experience with Next.js & Gemini
2
+
3
+ In the era of digital transformation, the traditional paper wedding invitation is becoming a relic of the past. But while digital invitations are rising, most are just static landing pages. I wanted something moreโ€”something interactive, intelligent, and truly helpful for both the couple and the guests.
4
+
5
+ Thatโ€™s why I built **Wedding Website Generator v2.0**, a production-ready CLI tool that scaffolds a complete, high-end wedding application in minutes.
6
+
7
+ ---
8
+
9
+ ## ๐Ÿš€ The Vision: Beyond the Static Page
10
+
11
+ Most wedding websites provide a map and a date. My goal was to build a **digital concierge**. Guests always have questions: *"Where is the parking?"*, *"What time does the ceremony start?"*, *"What is the dress code?"*.
12
+
13
+ By integrating **Google Gemini 2.5-flash**, Iโ€™ve created a sitewide AI assistant that is trained on the couple's specific wedding data. It doesn't just display info; it talks to your guests.
14
+
15
+ ## โœจ Core Features at a Glance
16
+
17
+ ### ๐Ÿค– AI-Powered Intelligence
18
+ * **Wedding Concierge**: A floating chatbot that answers guest queries about venues, schedules, and the couple's story in real-time.
19
+ * **Sentiment Wall**: AI analysis that summarizes guest wishes into a beautiful "Collective Blessing" paragraph.
20
+
21
+ ### ๐Ÿ“ธ Interactive Guest Experience
22
+ * **Personalized Invitations**: Every guest gets a unique ID and URL. They only see the events they are specifically invited to.
23
+ * **Digital Guestbook**: A masonry-style gallery where guests can upload photos directly from their phones (powered by Cloudinary).
24
+ * **Reception Playlist**: A real-time queue where guests can request songs they want to hear.
25
+
26
+ ### ๐ŸŽฎ The "Control Center" (Admin Dashboard)
27
+ Managing a guest list of 500 people is a nightmare. The generator includes a secure dashboard where the couple can:
28
+ * Add/Edit guest details and invitation types.
29
+ * Track RSVPs and food preferences in real-time.
30
+ * Generate pre-filled WhatsApp messages for one-click sharing.
31
+
32
+ ### ๐ŸŽฅ Live Event Broadcast
33
+ The site includes a dedicated `/updates/overlay` route designed for **OBS**. You can display scrolling "Live News" updates and a synchronized clock on the venue's big screens during the event.
34
+
35
+ ---
36
+
37
+ ## ๐Ÿ› ๏ธ The Tech Stack
38
+
39
+ Building a scalable, real-time app required a modern stack:
40
+ * **Framework**: Next.js 15 (App Router)
41
+ * **UI/UX**: HeroUI (formerly NextUI) + Framer Motion for elegant animations.
42
+ * **Database**: Firebase Firestore for real-time updates.
43
+ * **Auth**: Firebase Authentication.
44
+ * **AI**: Google Gemini AI.
45
+ * **Media**: Cloudinary (Image resizing and storage).
46
+ * **Email**: Resend API for automated guest reminders.
47
+
48
+ ---
49
+
50
+ ## ๐Ÿš€ Quick Start: Make it Yours
51
+
52
+ One of the best parts about this project is that it is an **npm utility**. You don't need to clone a repo and manually search-and-replace strings.
53
+
54
+ ### 1. Generate
55
+ Simply run:
56
+ ```bash
57
+ npx @titas_mallick/wedding-site-gen
58
+ ```
59
+ The CLI will ask for the couple's names, the wedding date, and your preferred theme. It then generates a sanitized, personalized codebase.
60
+
61
+ ### 2. Configure
62
+ Fill in your `.env.local` with your Firebase and Gemini keys. Deploy the included Firestore rules, and you are ready to go.
63
+
64
+ ### 3. Personalize
65
+ Replace the placeholder images in the `/public/` folder with your own pre-wedding portraits and milestone photos. The masonry gallery will automatically detect and display them.
66
+
67
+ ---
68
+
69
+ ## ๐Ÿ“œ Final Thoughts
70
+
71
+ Weddings are about stories. By using AI and modern web tech, we can tell those stories in a way that is engaging, modern, and stress-free. Whether you're a developer looking to build a site for a friend or a tech-savvy couple, this tool provides a professional foundation to build upon.
72
+
73
+ **Explore the Project:**
74
+ * ๐Ÿ“ฆ **NPM Package**: [@titas_mallick/wedding-site-gen](https://www.npmjs.com/package/@titas_mallick/wedding-site-gen)
75
+ * ๐Ÿ’ป **GitHub Repository**: [titasmallick/wedding-site-gen](https://github.com/titasmallick/wedding-site-gen)
76
+
77
+ **Happy Building, and Happy Wedding!** ๐Ÿ’โœจ
78
+
79
+ ---
80
+ *If you find this tool useful, feel free to contribute to the project or share your feedback!*
package/README.md CHANGED
@@ -1,5 +1,8 @@
1
1
  # ๐Ÿ’ Wedding Website Generator v2.0 (AI-Powered)
2
2
 
3
+ [![NPM Version](https://img.shields.io/npm/v/@titas_mallick/wedding-site-gen?color=pink)](https://www.npmjs.com/package/@titas_mallick/wedding-site-gen)
4
+ [![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-blue?logo=github)](https://github.com/titasmallick/wedding-site-gen)
5
+
3
6
  > **The ultimate digital companion for your special day.** Scaffold, personalize, and deploy a feature-rich wedding application in minutes.
4
7
 
5
8
  ---
package/package.json CHANGED
@@ -1,7 +1,15 @@
1
1
  {
2
2
  "name": "@titas_mallick/wedding-site-gen",
3
- "version": "2.0.4",
3
+ "version": "2.0.5",
4
4
  "description": "A comprehensive AI-powered wedding website generator based on Next.js, Firebase, and Gemini AI.",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "git+https://github.com/titasmallick/wedding-site-gen.git"
8
+ },
9
+ "bugs": {
10
+ "url": "https://github.com/titasmallick/wedding-site-gen/issues"
11
+ },
12
+ "homepage": "https://github.com/titasmallick/wedding-site-gen#readme",
5
13
  "keywords": [
6
14
  "wedding",
7
15
  "wedding-website",