Releases: naborajs/birthday-bloom
Release list
Birthday Bloom v3.0.0 — Cinematic Animated Birthday Experience Engine (Stable Release)
🌸 Birthday Bloom v3.0
Production Upgrade • Env-First • Family Templates • Scalable Architecture
🚀 Welcome to v3
Birthday Bloom v3.0 transforms the project from a birthday website into a scalable, env-customizable cinematic celebration engine.
Built for creators, developers, and AI-assisted customization workflows.
📌 Release Navigation
- ✨ What's New
- ⚡ Quick Start
- 👨👩👧 Family Templates
- 🔐 Environment System
- 📚 Documentation
- ✅ Verification
- 🔄 Upgrade Notes
✨ What's New
🌍 Env-First Architecture
Customize the experience without touching React components.
- Name
- Relationship
- Photos
- Colors
- Messages
- Audio
- Videos
- Animation
- Visibility
- Accessibility
VITE_BIRTHDAY_NAME=Priya VITE_FAMILY_MEMBER_TYPE=sister VITE_BIRTHDAY_COLOR=#FF69B4 VITE_SHOW_QUIZ_SECTION=false
👨👩👧 New Family Template System
Create specialized celebration experiences with dedicated profiles.
| Core | Extended |
|---|---|
|
Brother |
Grandfather |
Supports:
- Dynamic fields
- Timeline history
- Media support
- Privacy controls
- Migration support
- Validation
⚡ Quick Start
git clone https://github.com/naborajs/birthday-bloom.git cd birthday-bloom npm install cp .env.example .env.local npm run dev
🔐 Environment Driven
AI coding agents should check:
.env.example docs/ENV_GUIDE.md
Most customization no longer requires editing components.
📚 Documentation
- README.md
- docs/ENV_GUIDE.md
- docs/family-system.md
- docs/template-architecture.md
- docs/developer-guide.md
- docs/migration-guide.md
- docs/DOCUMENTATION_INDEX.md
✅ Verification
npm run build npm run test npx tsc --noEmit npm run lint
✔ Build Pass
✔ Tests Pass
✔ Type Safety
✔ Lint Clean
🔄 Upgrade Notes
v2 was an internal milestone and was not publicly released.
This release continues directly:
v1 → v3
🌸 Birthday Bloom v3.0
Create memories. Not pages.
⭐ Star the repo
🍴 Fork it
🚀 Build something unforgettable
Birthday Bloom v1.0.0 — Cinematic Animated Birthday Experience Engine (Stable Release)
🌸 Birthday Bloom v1.0.0
Cinematic Animated Birthday Experience Engine — Stable Production Release
A premium open-source platform for creating emotionally immersive, animated birthday surprise websites.
🎉 Release Overview
We are proud to announce the first stable production release of Birthday Bloom, a cinematic animated birthday website generator designed to deliver deeply emotional, immersive digital experiences.
This release marks the transition from development to a fully stable, production-ready system optimized for performance, scalability, and customization.
Birthday Bloom transforms ordinary birthday wishes into interactive digital journeys powered by modern web technologies and physics-based animation systems.
🌐 Live Experience
✨ Core Highlights
🎭 Cinematic Storytelling Engine
• Multi-phase emotional journey
• Story-driven animation system
• Fake chat emotional buildup
• Smooth narrative transitions
• Cinematic timing orchestration
❤️ Physics-Based Animation System
• Heart convergence animation engine
• Physics-driven motion using Framer Motion
• Hardware accelerated transforms
• GPU optimized rendering
• 60 FPS smooth performance
🎂 Interactive SVG Cake System
• Fully interactive cake
• Multi-layer structure
• Candle blowing system
• Cake cutting logic
• Dynamic lighting effects
💬 Fake Chat Simulation Engine
• Typing animation system
• Realistic message timing
• Emotional progression logic
• Smooth UI transitions
📱 Mobile-First Responsive Design
• Fully responsive layout
• Works on all screen sizes
• Optimized for mobile devices
• Perfect scaling system
⚡ Performance Optimizations
This release includes extensive performance optimizations:
• GPU accelerated animations
• Optimized animation pipelines
• Minimal re-renders
• Efficient state management
• Lazy loading optimization
• Lighthouse score target: 95+
🧠 Technical Stack
| Frontend Framework | React 18 |
| Animation Engine | Framer Motion |
| Styling System | Tailwind CSS |
| Build Tool | Vite |
| Deployment | Vercel |
🏗️ System Architecture
Birthday Bloom operates using a multi-phase state machine:
• Splash Screen
• Cinematic Intro
• Fake Chat Engine
• Emotional Narrative
• Heart Merge Animation
• Interactive Dashboard
• Cake Interaction
• Gallery Experience
📂 Project Structure
src/
├── components/
│ ├── birthday/
│ ├── animations/
│ └── ui/
│
├── config/
│ └── personalization engine
│
├── assets/
│ └── media and visual elements
│
docs/
└── documentation system
🔧 Installation Guide
git clone https://github.com/naborajs/birthday-bloom.git
cd birthday-bloom
npm install
npm run dev⚙️ Environment Setup
Create a .env file:
VITE_BIRTHDAY_NAME=YourName
🚀 Deployment Guide
Deploy instantly using Vercel:
Or build manually:
npm run build🌟 SEO Optimization Features
• Open Graph support
• Social media previews
• Optimized metadata
• Fast loading speed
• Clean semantic HTML
🎨 Animation Engine Details
Birthday Bloom uses advanced animation orchestration including:
• Spring physics
• Smooth transitions
• Motion orchestration
• Hardware acceleration
🔒 Stability Improvements
This release fixes:
• Animation initialization issues
• Typing effect synchronization
• Layout overflow problems
• Mobile scaling issues
• Animation visibility issues
📚 Documentation
Full documentation available:
https://github.com/naborajs/birthday-bloom/tree/main/docs
Includes:
• Setup guide
• Customization guide
• Animation system guide
• Deployment guide
👤 Author
Created by:
Nishant Sarkar
NS GAMMiNG
GitHub:
https://github.com/naborajs
YouTube:
https://youtube.com/@Nishant_sarkar
Twitter:
https://x.com/NSGAMMING699
📜 License
MIT License
🌍 Future Roadmap
Planned upcoming features:
• More animation presets
• Theme customization system
• Visual editor
• Multi-language support
• Plugin system
⭐ Support the Project
If you like this project:
• Star the repository
• Fork the project
• Share with others
🌸 Birthday Bloom v1.0.0 — Stable Release
Crafting emotional digital experiences through technology.