Lumina - Realistic 3D PDF Flipbook React Viewer

Lumina Flipbook Pro is a cutting-edge React application that transforms standard PDF documents into immersive, photorealistic digital publications. Whether you are creating digital magazines, brochures, catalogs, or interactive ebooks, Lumina delivers a premium reading experience.

Built with the latest React 19 and Tailwind CSS, it features a modern Glassmorphism UI that floats beautifully over realistic leather and paper textures. The application uses hardware-accelerated 3D physics to simulate the actual weight and flexibility of paper, accompanied by synchronized sound effects for every page turn.

It is completely self-contained and requires no backend database—just upload your PDF and deploy.

Key Highlights:

• Zero Backend: Runs entirely as a static site (HTML/CSS/JS).
• Docker Ready: Includes a production-ready Docker setup with Nginx.
• High Performance: Optimized with Vite for lightning-fast loading.

Features

 Features

• React 19 & TypeScript: Built with the latest web technologies for stability and performance.
• Realistic 3D Page Flip: Smooth, physics-based page-turning animations.
• Direct PDF Rendering: Renders PDF files directly without conversion using PDF.js.
• Immersive Audio: Integrated Howler.js engine for realistic page-flip sound effects.
• Glassmorphism UI: Modern, translucent interface design with blur effects.
• Premium Textures: Includes photorealistic Leather and Paper backgrounds.
• Smart Zoom & Pan: Intuitive controls for reading fine print on any device.
• Fully Responsive: Adapts perfectly to desktops, tablets, and mobile phones.
• Docker Support: Comes with Dockerfile and docker-compose.yml for instant server deployment.

Requirements

 Requirements

• For Development: Node.js (v18+) and NPM installed on your local machine.
• For Hosting: Any standard web hosting (Shared, VPS, or Static Hosting like Netlify/Vercel) or a server with Docker support.

Instructions

Instructions

Installation:

1. Unzip the downloaded project file.
2. Open your terminal/command prompt in the project folder.
3. Run npm install to install all dependencies.
4. Run npm run dev to start the local preview server.

How to Build for Production:

1. Run the command npm run build. ###licode###dist folder.
2. Upload the contents of the dist folder to your web server (e.g., public_html or htdocs).

Docker Deployment:

1. Upload the project to your VPS.
2. Run docker-compose up -d --build. ###li/li###