Skip to content

About

🎁 A customizable interactive storybook combining memories, photos, quizzes, and heartfelt messages.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

3 Commits

Folders and files

Repository files navigation

Memory Lane ❀️

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.

✨ Features

  • 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

πŸ“‚ Project Structure

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

πŸ“ Customization Guide (For Reuse)

Want to make this for your own partner? Here's how:

  1. Clone or download this repository
  2. Edit src/data/content.json only:
    • Change meta.name to your partner's name
    • Rewrite all questions, options, and responses
    • Update correctIndex values 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
  3. Add your photos to public/images/
  4. Run npm run dev to preview
  5. Deploy to Vercel

The React code itself does not need any modification. Every word, every image, every response is in JSON.

Content Customization

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 πŸ˜„"
}
  • correctIndex is 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 ❀️" }

πŸ“¦ Installation

Run Locally

npm install
npm run dev

The app runs at http://localhost:5173

Production Build

npm run build
npm run preview

npm run build creates a dist/ folder. npm run preview serves it locally for a final check.

πŸš€ Deployment to Vercel (recommended)

  1. Push your project to a GitHub repository
  2. Go to vercel.com and sign in
  3. Click "New Project" β†’ Import your GitHub repo
  4. Vercel auto-detects Vite β€” leave all settings as default
  5. Click Deploy
  6. Your app is live at your-project.vercel.app

To update: push to GitHub β†’ Vercel redeploys automatically.

License

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.

About

🎁 A customizable interactive storybook combining memories, photos, quizzes, and heartfelt messages.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages