Single-page wedding invitation structure with hero, countdown, photo gallery, and RSVP form sections
ceremony-nextjs — Next.js Business Template
By georgekhananaev
A wedding invitation website template built on Next.js and React, using Tailwind CSS for layout, Framer Motion for animations, and Lucide React for icons, with content edited in a single configuration file.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Content centralized in app/config/settings.js, with couple information, dates, and venue maintained in one place
Uses Tailwind CSS for layout, Framer Motion for animations, and Lucide React for icons
Background music plays after the user scrolls or clicks, with floating play/pause controls
Built-in Open Graph, Twitter Card, and structured data for social sharing and SEO
Template Details
This is a single-page invitation website template for weddings or similar celebratory events, built with Next.js (App Router) and React. Styling is handled by Tailwind CSS, animations use Framer Motion, and icons come from Lucide React. The page includes sections such as a hero, countdown, photo gallery, and RSVP form, along with background music playback and a floating navigation that appears after scrolling.
Content customization is centralized in app/config/settings.js: the couple's names, wedding date and display date, venue, and time are all maintained in this file. Colors, images, and music are replaced in the configuration file, the public directory, and /public/music.mp3 respectively. The project structure splits each section into independent components under app/components, making it easy to adjust by section.
The template includes SEO-related configuration such as Open Graph, Twitter Card, and structured data, and distinguishes between desktop and mobile layouts. The repository uses the MIT license, allowing free use, modification, commercial use, and distribution, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services such as domains and hosting may incur costs.
Is it right for your project?
Use Cases
- Building a public information and invitation page for a wedding or engagement ceremony
- Creating a single-page site with countdown and photo display for anniversaries, thank-you banquets, or other celebratory events
- Using it as a practice project for Next.js + Tailwind CSS + Framer Motion to learn component splitting and centralized configuration management
Suitable For
- Developers or couples who need to quickly set up a wedding invitation page and replace copy and images themselves
- Front-end users familiar with React and Tailwind CSS who want to adjust page structure by component
- Projects planned for deployment to Vercel or other platforms supporting Next.js
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Requires Node.js 18 or later; install dependencies with npm or yarn
- 2
Copy .env.local.example to .env.local and set NEXT_PUBLIC_SITE_URL
- 3
Fill in couple information, wedding date, and venue in app/config/settings.js
- 4
Place photos in the corresponding folder under the public directory and replace background music with public/music.mp3
- 5
Third-party assets such as demo images, fonts, and icons must be checked against their respective licenses before use
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope applies to that version's code and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets require separate license verification and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional costs.
View Original Text Basis
https://github.com/georgekhananaev/ceremony-nextjs/blob/master/LICENSEhttps://github.com/georgekhananaev/ceremony-nextjs/blob/master/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-04. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 88 / 100
- Technologies
- Next.js · React
- Website type
- Corporate Website
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-01-28
- Screenshot last checked
- 2026-10-04
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Next.js as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: fa280208c2f9bdecfe26de4107f668ee05936ce62e89200f07dd15a36931108c
2026-10-04T02:50:55.288Z
Source file / repository# Elegant Wedding Template - Next.js
A beautiful, modern, and fully customizable wedding invitation website built with Next.js 14, Tailwind CSS, and Framer Motion. Perfect for couples who want to share their special day with a stunning digital presence.

## ✨ Features
### 🎨 Elegant Design
- Modern, responsive design that looks beautiful on all devices
- Smooth animations powered by Framer Motion
- Customizable color schemes and themes
- Beautiful gradient backgrounds and floating elements
### 🎵 Interactive Elements
- **Background Music**: Auto-plays when users interact with the site
- **Floating Menu**: Elegant navigation that appears on scroll
- **Countdown Timer**: Dynamic countdown to your wedding day
- **RSVP Form**: Integrated form for guest responses
- **Photo Gallery**: Showcase your engagement photos
### 📱 Fully Responsive
- Mobile-first design approach
- Optimized for all screen sizes
- Touch-friendly interactions
- Fast loading times
### 🔍 SEO Optimized
- Full Open Graph support for social media sharing
- Twitter Card integration
- Structured data for rich snippets
- Customizable meta tags
## 🚀 Quick Start
### Prerequisites
- Node.js 18+
- npm or yarn
### Installation
1. Clone the repository:
```bash
git clone https://github.com/georgekhananaev/elegant-wedding-template-nextjs.git
cd elegant-wedding-template-nextjs
```
2. Install dependencies:
```bash
npm install
# or
yarn install
```
3. Create a `.env.local` file:
```bash
cp .env.local.example .env.local
```
4. Update the environment variables:
```env
NEXT_PUBLIC_SITE_URL=https://your-wedding-site.com
```
5. Run the development server:
```bash
npm run dev
# or
yarn dev
```
Open [http://localhost:3000](http://localhost:3000) to see your wedding website!
## ⚙️ Configuration
### Wedding Details
All wedding information is centralized in `app/config/settings.js`:
```javascript
const settings = {
couple: {
bride: {
name: "Patinya",
fullName: "Patinya Surname",
// ... more details
},
groom: {
name: "Dar",
fullName: "Dar Surname",
// ... more details
}
},
wedding: {
date: "2026-03-07",
displayDate: "March 07, 2026",
// ... venue, time details
},
// ... more configurations
}
```
### Customizing Content
1. **Names & Details**: Edit `app/config/settings.js`
2. **Colors**: Modify theme colors in `settings.js` and Tailwind config
3. **Images**: Replace images in `/public` folder
4. **Music**: Add your song to `/public/music.mp3`
### Adding Your Photos
1. Place venue photos in `/public/botanical-house-bkk/`
2. Add couple photos to gallery section in settings
3. Update `thumbnail.png` for social media preview
## 📂 Project Structure
```
elegant-wedding-template-nextjs/
├── app/
│ ├── components/ # React components
│ │ ├── Hero.jsx # Landing section
│ │ ├── Countdown.jsx # Countdown timer
│ │ ├── Gallery.jsx # Photo gallery
│ │ ├── RSVPForm.jsx # Guest RSVP form
│ │ └── ...
│ ├── config/
│ │ └── settings.js # All wedding configuration
│ ├── layout.js # Root layout with SEO
│ └── page.js # Main page
├── public/
│ ├── music.mp3 # Background music
│ ├── thumbnail.png # Social media preview
│ └── ...
└── package.json
```
## 🎵 Background Music
The template includes an elegant background music feature:
- Starts playing when users scroll or click
- Floating control button for play/pause
- Respects user preferences
- Optimized for browser autoplay policies
To use your own music:
1. Add your MP3 file as `/public/music.mp3`
2. The music will automatically loop
3. Volume is set to 30% by default
## 🎨 Customization Guide
### Colors
The template uses a romantic color palette:
- Primary: `#1a1a1a` (Elegant Black)
- Accent: `#d4af37` (Gold)
- Background: `#faf8f3` (Cream)
- Additional: `#87a878` (Sage), `#ff6b6b` (Coral)
### Fonts
- Headings: Playfair Display (Elegant serif)
- Body: Inter (Clean sans-serif)
### Components
Each component is fully customizable:
- Edit component files in `/app/components/`
- Adjust animations in component files
- Modify styles using Tailwind classes
## 📸 Screenshots
### Desktop View
- Elegant hero section with animated elements
- Smooth scrolling between sections
- Interactive countdown timer
### Mobile View
- Responsive navigation
- Touch-optimized interactions
- Perfect formatting on all devices
## 🔧 Development
### Available Scripts
```bash
# Development server
npm run dev
# Production build
npm run build
# Start production server
npm start
# Lint code
npm run lint
```
### Tech Stack
- **Framework**: Next.js 14 (App Router)
- **Styling**: Tailwind CSS
- **Animations**: Framer Motion
- **Icons**: Lucide React
- **Font**: Google Fonts (Playfair Display, Inter)
## 📦 Deployment
### Vercel (Recommended)
1. Push your code to GitHub
2. Import project to Vercel
3. Add environment variables
4. Deploy!
### Other Platforms
The template can be deployed to any platform that supports Next.js:
- Netlify
- AWS Amplify
- Google Cloud Run
- Self-hosted with Node.js
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 👨💻 Author
**George Khananaev**
- GitHub: [@georgekhananaev](https://github.com/georgekhananaev)
## 🙏 Acknowledgments
- Built with love for Patinya & Dar's special day
- Inspired by modern wedding design trends
- Thanks to the Next.js and React communities
## 💝 Support
If you found this template helpful, please consider:
- ⭐ Starring the repository
- 🍴 Forking for your own use
- 📢 Sharing with others who might need it
---
Made with ❤️ by George Khananaev | 2025Explore similar templates
Compare previews and descriptions within the same stack and category.

SaaS-Boilerplate
SaaS-Boilerplate is an open-source SaaS starter template built with Next.js App Router, React 19, TypeScript, Tailwind CSS, and Shadcn UI.
Next.js · SaaS

Next-JS-Landing-Page-Starter-Template
A free Next.js landing page starter template written in Tailwind CSS and TypeScript, featuring built-in navbar, hero, features, CTA banner, and footer sections.
Next.js · Corporate Website

next-saas-starter
A free Next.js SaaS marketing landing page template from Blazity, using static generation and styled-components with no extra UI library.
Next.js · SaaS

startup-nextjs
Startup is a free, MIT-licensed Next.js template from NextJSTemplates for SaaS startups and corporate landing pages.
Next.js · SaaS

shadcn-landing-page
A Next.js landing page template built with Shadcn, TypeScript, and Tailwind, converted from a Shadcn-Vue version. It includes sections such as Navbar, mobile Sidebar, Hero, Pricing, FAQ, and Footer, and highlights responsive design, navigation, and dark mode.
Next.js · Corporate Website

shadcn-dashboard-landing-template
An open-source admin dashboard and marketing landing page template built on shadcn/ui and Tailwind CSS, with both Vite + React and Next.js versions in one repository.
Next.js · Admin dashboard
