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

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors