A beautiful, responsive wedding website designed to be hosted on GitHub Pages with a custom domain from GoDaddy.
- Responsive Design: Looks great on all devices (desktop, tablet, mobile)
- Interactive Elements:
- Live countdown timer to wedding day
- Photo gallery with modal viewer
- RSVP form with validation
- Smooth scrolling navigation
- Floating animations
- Multiple Sections:
- Hero section with countdown
- Love story timeline
- Wedding details (ceremony, reception, accommodations)
- Photo gallery
- RSVP form
- Gift registry links
- Modern Styling: Beautiful typography, elegant colors, and smooth animations
Edit the following placeholders in index.html:
[Your Names]- Replace with bride and groom names[Bride Name]- Replace with bride's name[Groom Name]- Replace with groom's name[Wedding Date]- Replace with your wedding date[Wedding Venue, City]- Replace with venue and location[Time]- Replace with ceremony/reception times[Ceremony Venue Name]- Replace with ceremony venue[Reception Venue Name]- Replace with reception venue[Full Address]- Replace with venue addresses[Google Maps Link]- Replace with actual Google Maps links[Hotel Name]- Replace with recommended hotel[Dress Code]- Replace with your dress code[RSVP Deadline]- Replace with RSVP deadline[Amazon Registry Link]- Replace with registry links[Instagram Link]- Replace with social media links[Email Address]- Replace with contact email[YourWeddingHashtag]- Replace with your wedding hashtag
In script.js, update the wedding date:
const weddingDate = new Date('2025-06-15T15:00:00').getTime(); // Change this dateReplace the placeholder images in the images/ folder:
hero-bg.jpg- Main background image for hero sectiongallery-1.jpgthroughgallery-6.jpg- Engagement/couple photosamazon-logo.png- Amazon registry logotarget-logo.png- Target registry logohoneymoon-fund.png- Honeymoon fund image
Recommended image sizes:
- Hero background: 1920x1080px or larger
- Gallery images: 800x800px (square format works best)
- Logo images: 200x200px
- Create a new repository on GitHub
- Upload all files to the repository
- Go to repository Settings > Pages
- Select "Deploy from a branch" and choose "main" branch
- Your site will be available at
https://yourusername.github.io/repository-name
- In your GitHub repository settings, go to Pages
- Add your custom domain (e.g.,
yournames.com) - In your GoDaddy DNS settings, add these records:
A Records (point to GitHub Pages IPs):
185.199.108.153
185.199.109.153
185.199.110.153
185.199.111.153
CNAME Record:
- Name:
www - Value:
yourusername.github.io
Wait 24-48 hours for DNS propagation.
Update CSS variables in styles.css:
:root {
--primary-color: #d4af37; /* Gold */
--secondary-color: #8b4513; /* Brown */
--accent-color: #f5f5dc; /* Beige */
}Current fonts used:
- Dancing Script (elegant script)
- Playfair Display (serif headers)
- Open Sans (body text)
The form currently shows a success message. To collect actual responses:
- Use a service like Formspree, Netlify Forms, or Google Forms
- Update the form action in
index.html - Modify the JavaScript submission handler in
script.js
Uncomment the music player code in script.js and add a wedding song MP3 file to a music/ folder.
wedding/
├── index.html # Main HTML file
├── styles.css # CSS styling
├── script.js # JavaScript functionality
├── images/ # Image folder
│ ├── hero-bg.jpg
│ ├── gallery-1.jpg
│ ├── gallery-2.jpg
│ └── ...
└── README.md # This file
- Chrome (recommended)
- Firefox
- Safari
- Edge
- Mobile browsers
- Optimize images (compress before uploading)
- Use WebP format for better compression
- Keep total site size under 100MB for GitHub Pages
- Test on mobile devices
- Check GitHub Pages documentation
- Test your site locally by opening
index.htmlin a browser - Use browser developer tools to debug issues
- Ensure all image paths are correct and files exist
This template is free to use for personal wedding websites. Customize as needed for your special day!
Congratulations on your upcoming wedding! 💕
Last updated: December 4, 2025