Memory Lane is a fully vibe-coded, interactive, mobile-first React application.
It takes the recipient on a 24-page cinematic journey β beginning with a mysterious terminal boot-up screen, moving through "alternate universe" memories that never happened, a relationship quiz, a photo slideshow, a celebration page with confetti, a future archive, a personal letter, and finally an emotional closing screen. Think of it as a storybook, a visual novel, and a personalized love letter combined into a single interactive experience. You can change the name to Your Day / Our Day.
ποΈ I originally built it as a birthday gift for my girlfriend. While the current version is birthday-themed, it can easily be adapted into an anniversary gift, proposal, farewell message, friendship tribute, or any other deeply personal occasion.
N.B: Everything is driven by a single JSON file (src/data/content.json). Questions, images, captions, letters, future cards, and messages can all be customized without touching the React code.
- 24 unique, fully animated pages
- Dark β warm β colorful β emotional visual journey
- Glassmorphism UI with soft gradients and elegant typography
- Canvas-based confetti system (Pages 16, 17, 24)
- Typewriter animation for the birthday letter (Page 23)
- Interactive quiz logic (wrong answers never block progress)
- Image galleries with swipe-style navigation and dot indicators
- Auto-advancing slideshow with manual override
- Floating balloons and emoji animations on the birthday page
- Star field backgrounds on dark/atmospheric pages
- Animated progress bars tracking memory recovery
- Locked future cards with subtle pulse animations
- Skip button for the typewriter letter
- Page counter indicator (bottom-right, subtle)
- Framer Motion page transitions (blur + fade + slide)
- Mobile-first, fully responsive layout
- No backend, no database, no API calls, no music
- Vercel-compatible static build
memory-lane/
βββ public/
β βββ images/ β Place ALL your photos here
βββ src/
β βββ components/
β β βββ Button.jsx β Reusable button with variants
β β βββ Confetti.jsx β Canvas confetti engine
β β βββ ImageWithFallback.jsx β Image with emoji placeholder fallback
β β βββ PageWrapper.jsx β Framer Motion page transition wrapper
β β βββ ProgressBar.jsx β Animated gradient progress bar
β β βββ StarField.jsx β Randomized twinkling star background
β βββ hooks/
β β βββ useTypewriter.js β Typewriter + sequential line reveal hooks
β βββ pages/
β β βββ Page1.jsx β Loading archive terminal
β β βββ Page2.jsx β "Hey" reveal
β β βββ Page3.jsx β Alternate universe intro
β β βββ MissingMemoryPage.jsx β Reused for pages 4 & 5 (corrupted photos)
β β βββ Page6.jsx β Funny "most attractive" guess
β β βββ Page7.jsx β Sequential text β "here we are"
β β βββ Page8.jsx β Progress bar start
β β βββ QuestionPage.jsx β Reused for pages 9, 10, 13 (quiz chapters)
β β βββ Page11.jsx β First date gallery (9 photos)
β β βββ Page12.jsx β Trip question + photo grid
β β βββ Page14.jsx β Multi-question birthday girl analysis
β β βββ Page15.jsx β 12-photo auto slideshow
β β βββ Page16.jsx β Story complete + emotional message
β β βββ Page17.jsx β Happy Birthday celebration + confetti
β β βββ Page18.jsx β Future archive scan terminal
β β βββ ArchiveStatsPage.jsx β Reused for pages 19 & shared stats
β β βββ Page20.jsx β Future archive explanation
β β βββ Page21.jsx β Locked future cards
β β βββ Page22.jsx β "Best memories still waiting"
β β βββ Page23.jsx β Typewriter birthday letter
β β βββ Page24.jsx β Final screen + glowing button
β βββ data/
β β βββ content.json β β THE ONLY FILE YOU NEED TO EDIT
β βββ App.jsx β Page orchestrator (no editing needed)
β βββ main.jsx β React entry point
β βββ index.css β Global styles + Tailwind
βββ index.html
βββ vite.config.js
βββ tailwind.config.js
βββ postcss.config.js
βββ package.json
Want to make this for your own partner? Here's how:
- Clone or download this repository
- Edit
src/data/content.jsononly:- Change
meta.nameto your partner's name - Rewrite all questions, options, and responses
- Update
correctIndexvalues to match your correct answers - Replace all image paths with your own photos
- Rewrite the birthday letter in
page23.letter - Update future cards in
page21.cards - Change captions throughout
- Change
- Add your photos to
public/images/ - Run
npm run devto preview - Deploy to Vercel
The React code itself does not need any modification. Every word, every image, every response is in JSON.
You only ever need to edit src/data/content.json.
1. Change the name
"meta": {
"name": "XX"
}"XX" refers to the Girl's name & "YY" refers to the Boy's name.
2. Change questions and options
"page9": {
"question": "Who sent the first message?",
"options": ["Option A", "Option B"],
"correctIndex": 0,
"correctResponse": "Yes! That's right β¨",
"wrongResponse": "Not quite, but that's okay π"
}correctIndexis zero-based (0 = first option, 1 = second, etc.)- Wrong answers never block progress β the app always continues
3. Change images
Place all images in public/images/. Reference them in JSON like:
"image": "/images/filename.jpg"For galleries:
"images": [
{ "src": "/images/photo1.jpg", "caption": "That golden evening β¨" },
{ "src": "/images/photo2.jpg", "caption": "My favourite memory" }
]Supported formats: JPG, PNG, WebP, GIF, AVIF
Recommended sizes:
- Gallery/slideshow images: 800Γ600px or larger, under 500KB each
- Single featured images: 600Γ800px (portrait) or 800Γ600px (landscape)
If an image is missing or fails to load, a cute emoji placeholder appears automatically β so the app always works even without photos.
4. Change the letter
"page23": {
"title": "A Letter, For Today",
"letter": "Hey [Name],\n\nYour letter goes here...\n\nWith love,\n[Your name]"
}Use \n for new lines within the JSON string.
5. Change future cards
"page21": {
"cards": [
{ "emoji": "π", "title": "Our First Trip", "hint": "Somewhere new, together" },
{ "emoji": "π", "title": "Another Birthday", "hint": "This one, but next year" }
]
}6. Change captions
Every gallery image supports a caption:
{ "src": "/images/slide-5.jpg", "caption": "The chaotic one β€οΈ" }npm install
npm run devThe app runs at http://localhost:5173
npm run build
npm run previewnpm run build creates a dist/ folder. npm run preview serves it locally for a final check.
- Push your project to a GitHub repository
- Go to vercel.com and sign in
- Click "New Project" β Import your GitHub repo
- Vercel auto-detects Vite β leave all settings as default
- Click Deploy
- Your app is live at
your-project.vercel.app
To update: push to GitHub β Vercel redeploys automatically.
MIT License
Copyright (c) 2024
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.