Skip to content

Retro Coffee Co. – A unique blend of vintage charm and futuristic coffee experiences! Explore gravity-defying brews, time-shifted tastings, and neural-enhanced aromas in this fully responsive React web app. Built with Tailwind CSS and powered by Framer Motion animations, this site delivers a smooth, engaging user experience.

Notifications You must be signed in to change notification settings

StarKnightt/Coffee-Website

Repository files navigation

☕ Quantum Coffee - A Next-Generation Coffee Experience

Quantum Coffee React Tailwind CSS Framer Motion

A cutting-edge, fully responsive coffee shop website that blends quantum physics with coffee culture. Experience coffee beyond reality with our futuristic design, smooth animations, and exceptional user experience.

🌐 Live Demo

Check out the live demo: Quantum Coffee Website

✨ Features

🎨 Professional Design System

  • Custom Color Palette: Quantum-themed colors (orange, pink, purple, blue, teal)
  • Consistent Typography: Inter for body text, Space Grotesk for headings
  • Gradient Text Effects: Stunning gradient animations throughout
  • Glassmorphism Effects: Modern backdrop blur and transparency
  • Custom Animations: Float, gradient, pulse effects

🚀 Performance Optimizations

  • Lazy Loading: Components and images load on-demand
  • Image Optimization: WebP and AVIF formats for faster loading
  • Code Splitting: Automatic chunking for optimal performance
  • Memoization: React.memo and useCallback for efficient rendering
  • Preloading: Critical resources preloaded for instant display

Accessibility (WCAG 2.1 AA Compliant)

  • Keyboard Navigation: Full keyboard support with visible focus states
  • ARIA Labels: Comprehensive screen reader support
  • Semantic HTML: Proper heading hierarchy and landmarks
  • Alt Text: Descriptive alternative text for all images
  • Focus Management: Logical tab order and focus trapping in modals
  • Motion Preferences: Respects prefers-reduced-motion
  • High Contrast Support: Adapts to high contrast preferences

📱 Responsive Design

  • Mobile-First Approach: Optimized for all screen sizes
  • Breakpoint System: sm, md, lg, xl, 2xl breakpoints
  • Touch Optimizations: Proper touch targets and gestures
  • Flexible Layouts: Grid and flexbox for adaptive layouts
  • Responsive Typography: Fluid text scaling

🎭 Advanced Features

  • Error Boundaries: Graceful error handling with custom UI
  • Loading States: Beautiful skeleton screens and spinners
  • Scroll to Top: Smooth scroll button with animation
  • Modal System: Accessible modal with focus trap and escape key
  • Smooth Scrolling: Native smooth scroll with polyfill
  • Hero Carousel: Auto-rotating background images with controls

🔒 SEO & Meta Tags

  • Open Graph Tags: Rich social media previews
  • Twitter Cards: Optimized Twitter sharing
  • Meta Descriptions: Search engine optimized
  • Semantic Structure: Proper document outline
  • Mobile Viewport: Correct mobile rendering

🛠️ Tech Stack

  • Framework: React 18.3
  • Styling: Tailwind CSS 3.4
  • Animations: Framer Motion 11.5
  • Icons: Lucide React
  • Build Tool: Vite 5.4
  • Linting: ESLint 9.9

📦 Installation

# Clone the repository
git clone https://github.com/StarKnightt/Coffee-Website.git

# Navigate to project directory
cd Coffee-Website

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

🏗️ Project Structure

Coffee-Website/
├── public/
│   └── images/           # Optimized images (WebP/AVIF)
├── src/
│   ├── components/
│   │   ├── About.jsx           # Company story section
│   │   ├── ErrorBoundary.jsx   # Error handling wrapper
│   │   ├── Experience.jsx      # Quantum experience features
│   │   ├── Footer.jsx          # Site footer with links
│   │   ├── Header.jsx          # Navigation header
│   │   ├── Hero.jsx            # Hero section with carousel
│   │   ├── LoadingSpinner.jsx  # Loading state component
│   │   ├── Menu.jsx            # Product menu grid
│   │   ├── Modal.jsx           # Product detail modal
│   │   ├── ScrollToTop.jsx     # Scroll to top button
│   │   └── Testimonials.jsx    # Customer reviews
│   ├── App.jsx          # Main app component
│   ├── App.css          # Custom styles
│   ├── index.css        # Global styles & Tailwind
│   └── main.jsx         # App entry point
├── index.html           # HTML template with meta tags
├── tailwind.config.js   # Tailwind configuration
├── vite.config.js       # Vite configuration
└── package.json         # Dependencies

🎨 Design System

Colors

quantum: {
  blue: '#3B82F6',
  purple: '#8B5CF6',
  pink: '#EC4899',
  orange: '#F97316',
  teal: '#14B8A6',
}

Typography

  • Headings: Space Grotesk (400-700)
  • Body: Inter (300-800)
  • Mono: JetBrains Mono

Animations

  • gradient-x: Horizontal gradient animation
  • gradient-y: Vertical gradient animation
  • gradient-xy: Diagonal gradient animation
  • float: Floating effect
  • pulse-slow: Slow pulse effect
  • glow: Glowing shadow effect

🔑 Key Improvements Made

1. Branding Consistency

  • ✅ Unified Quantum Coffee theme throughout
  • ✅ Removed conflicting content
  • ✅ Consistent quantum/futuristic messaging

2. Professional Design

  • ✅ Custom design system with brand colors
  • ✅ Gradient text effects and animations
  • ✅ Glassmorphism and modern UI patterns
  • ✅ Professional typography hierarchy

3. Enhanced User Experience

  • ✅ Smooth page transitions
  • ✅ Interactive hover effects
  • ✅ Loading states and error handling
  • ✅ Scroll to top functionality
  • ✅ Enhanced modal interactions

4. Accessibility

  • ✅ Full keyboard navigation
  • ✅ Screen reader support (ARIA)
  • ✅ Focus visible states
  • ✅ Semantic HTML structure
  • ✅ Motion preference respect

5. Performance

  • ✅ Lazy loading components
  • ✅ Image optimization
  • ✅ React.memo optimization
  • ✅ Code splitting

6. SEO & Meta

  • ✅ Comprehensive meta tags
  • ✅ Open Graph tags
  • ✅ Twitter Card tags
  • ✅ Semantic HTML

7. Mobile Experience

  • ✅ Responsive design system
  • ✅ Touch-optimized interactions
  • ✅ Mobile navigation drawer
  • ✅ Flexible layouts

🌐 Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)
  • Mobile browsers (iOS Safari, Chrome Mobile)

🚀 Deployment

This project is deployed on Vercel. To deploy your own version:

  1. Fork this repository
  2. Connect your Vercel account
  3. Import the project
  4. Deploy with one click

📄 License

This project is open source and available under the MIT License.

👨‍💻 Developer

Created by StarKnight

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

⭐ Show Your Support

Give a ⭐️ if you like this project!


Note: This project showcases modern web development practices including responsive design, accessibility features, performance optimization, and advanced React patterns.

About

Retro Coffee Co. – A unique blend of vintage charm and futuristic coffee experiences! Explore gravity-defying brews, time-shifted tastings, and neural-enhanced aromas in this fully responsive React web app. Built with Tailwind CSS and powered by Framer Motion animations, this site delivers a smooth, engaging user experience.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published