Skip to content

aldotobing/virosu

Repository files navigation

VIROSU - Premium Extrait de Parfum E-commerce

A stunning, modern e-commerce website for VIROSU, a premium perfume brand specializing in Extrait de Parfum with 12-24 hour longevity. The website showcases luxury fragrances with an elegant, sophisticated design that reflects the brand's premium positioning.

🌟 Features

  • Responsive Design: Fully responsive layout that works seamlessly across all devices
  • Interactive Product Carousel: Smooth, animated carousel showcasing featured products
  • Product Detail Pages: Comprehensive product information with olfactory notes and highlights
  • Search Functionality: Quick search to find specific fragrances
  • Shopping Cart: Integrated cart system for seamless purchasing
  • SEO Optimized: Proper meta tags, structured data, and social media integration
  • Performance Optimized: Image optimization and lazy loading for fast loading times
  • Smooth Animations: Framer Motion powered animations for enhanced user experience

πŸ› οΈ Technology Stack

Frontend Framework

  • React 19: Modern component-based architecture
  • Vite 7: Fast build tool and development server
  • React Router DOM 7: Client-side routing

Styling & UI

  • Tailwind CSS 3.4: Utility-first CSS framework for rapid UI development
  • Framer Motion: Advanced animations and gestures
  • Lucide React: Beautiful, accessible icon library

Development Tools

  • Vite Imagetools: Image optimization and processing
  • PostCSS & Autoprefixer: CSS processing and vendor prefixing

Performance & Optimization

  • Image Optimization: WebP format with responsive sizing
  • Lazy Loading: Images and components load as needed
  • Intersection Observer: For scroll-based loading and animations

πŸ“ Project Structure

virosu/
β”œβ”€β”€ public/                 # Static assets
β”‚   β”œβ”€β”€ assets/            # Product images and brand assets
β”‚   β”œβ”€β”€ robots.txt         # SEO configuration
β”‚   └── sitemap.xml        # Site map
β”œβ”€β”€ src/                   # Source code
β”‚   β”œβ”€β”€ components/        # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ CarouselProductCard.jsx
β”‚   β”‚   β”œβ”€β”€ CartSidebar.jsx
β”‚   β”‚   β”œβ”€β”€ Hero.jsx
β”‚   β”‚   β”œβ”€β”€ LazyImage.jsx
β”‚   β”‚   β”œβ”€β”€ Navbar.jsx
β”‚   β”‚   β”œβ”€β”€ ProductCard.jsx
β”‚   β”‚   β”œβ”€β”€ ProductSection.jsx
β”‚   β”‚   β”œβ”€β”€ ScentCarousel.jsx
β”‚   β”‚   β”œβ”€β”€ SearchModal.jsx
β”‚   β”‚   └── SplashScreen.jsx
β”‚   β”œβ”€β”€ data/              # Product and content data
β”‚   β”‚   β”œβ”€β”€ optimizedProducts.js
β”‚   β”‚   β”œβ”€β”€ products.js
β”‚   β”‚   β”œβ”€β”€ about.json
β”‚   β”‚   └── raw_details.json
β”‚   β”œβ”€β”€ pages/             # Route components
β”‚   β”‚   β”œβ”€β”€ Home.jsx
β”‚   β”‚   └── ProductDetail.jsx
β”‚   β”œβ”€β”€ styles/            # Custom styles
β”‚   β”œβ”€β”€ utils/             # Utility functions
β”‚   β”œβ”€β”€ App.jsx            # Main application component
β”‚   β”œβ”€β”€ index.css          # Global styles
β”‚   └── main.jsx           # Application entry point
β”œβ”€β”€ package.json           # Dependencies and scripts
β”œβ”€β”€ vite.config.js         # Vite configuration
β”œβ”€β”€ tailwind.config.js     # Tailwind CSS configuration
└── postcss.config.js      # PostCSS configuration

πŸš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or pnpm package manager

Installation

  1. Clone the repository:
git clone <repository-url>
cd virosu
  1. Install dependencies:
# Using npm
npm install

# Using pnpm (as indicated by pnpm-lock.yaml)
pnpm install
  1. Start the development server:
npm run dev
# or
pnpm dev
  1. Open your browser to http://localhost:5173

Available Scripts

  • npm run dev - Start development server with hot reloading
  • npm run build - Build for production
  • npm run preview - Preview production build locally
  • npm run lint - Run ESLint for code quality checks

🎨 Design System

Color Palette

  • Onyx (#050505): Primary background
  • Charcoal (#121212): Secondary background
  • Gold (#D4AF37): Accent color for highlights
  • Silver (#E0E0E0): Text color

Typography

  • Montserrat: Primary sans-serif font
  • Playfair Display: Serif font for headings and elegant text

Custom Utilities

  • Glass Panel: Frosted glass effect for UI elements
  • Text Glow: Subtle text glow effect
  • Scrollbar Hide: Custom scrollbar styling
  • Responsive Background: Subtle noise pattern

πŸ“¦ Key Components

ScentCarousel

An interactive, animated carousel showcasing featured products with:

  • Smooth transitions between items
  • Auto-rotation with pause on hover
  • Mobile swipe support
  • Loading states and skeleton screens

Product Detail Pages

Comprehensive product information including:

  • Olfactory notes (top, heart, base)
  • Product highlights and benefits
  • Image gallery with thumbnail navigation
  • Size selection options
  • Social sharing functionality

Navigation & Layout

  • Responsive navbar with mobile menu
  • Elegant hero section with animated elements
  • Product cards with detailed information
  • Search modal for quick product discovery

πŸ“ˆ Performance Features

  • Image Optimization: All images are optimized to WebP format with responsive sizing
  • Lazy Loading: Components and images load as they come into view
  • Code Splitting: Route-based code splitting for faster initial load
  • Intersection Observer: Efficient scroll-based loading and animations
  • Memory Management: Proper cleanup of event listeners and observers

πŸ”§ Custom Hooks & Utilities

  • Meta Tag Management: Dynamic meta tag updates for SEO
  • Image Optimization: Custom image processing and optimization
  • State Persistence: LocalStorage-based state preservation across sessions

πŸ“± Responsive Design

The website is fully responsive and optimized for:

  • Mobile: Touch-friendly interface with swipe gestures
  • Tablet: Balanced layout between mobile and desktop
  • Desktop: Full-featured experience with enhanced visual elements

🌐 SEO & Social Integration

  • Meta Tags: Comprehensive meta tag configuration
  • Open Graph: Social media sharing optimization
  • Structured Data: JSON-LD for rich search results
  • Canonical URLs: Proper duplicate content handling

🚒 Deployment

The application is built with Vite and can be deployed to any static hosting service. The build process creates optimized assets ready for production.

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Commit your changes (git commit -m 'Add some amazing feature')
  5. Push to the branch (git push origin feature/amazing-feature)
  6. Open a Pull Request

πŸ“„ License

This project is licensed under the ISC License.

πŸ“ž Support

For support, please contact the development team or open an issue in the repository.


VIROSU - Where Scent Becomes Identity

About

A modern website for a premium perfume brand specializing in Extrait de Parfum. The website showcases luxury fragrances with an elegant, sophisticated design that reflects the brand's premium positioning.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors