Skip to content

NYN-05/Foxnut_Farm

Repository files navigation

πŸͺ· Foxnuts Farm - Premium Web Application

A fully responsive, production-ready React web application showcasing Foxnuts Farm's premium, sustainably harvested foxnuts (makhana). Built with modern web technologies and designed to deliver an exceptional user experience.

Foxnuts Farm Tailwind Framer Motion

✨ Features

🎨 Design Highlights

  • Premium Color Palette: Soft sage green, lavender mauve, and cream white
  • Professional Typography: Playfair Display for headings, Inter for body text
  • Smooth Animations: Powered by Framer Motion for engaging user interactions
  • Fully Responsive: Mobile-first design that works perfectly on all devices

🌟 Key Sections

  1. Hero Section

    • Full-screen immersive banner with gradient overlay
    • Compelling headline and call-to-action
    • Four feature icons (Guilt Free, Sustainable, Organic, Community)
    • Smooth scroll indicator
  2. Featured Products

    • Three premium product cards with hover effects
    • Beautiful gradient backgrounds
    • Add to cart functionality
    • Responsive grid layout
  3. Farm Section

    • Interactive farm location display
    • Live statistics (7,500+ bags sold)
    • Customer testimonial showcase
    • Farm metrics cards
  4. Personality Quiz

    • Interactive 3-question quiz
    • Progress tracking with visual indicators
    • Personalized product recommendations
    • Beautiful result display with circular progress chart
  5. Sustainability Meter

    • Animated progress bars showing environmental metrics
    • 90% Water Recycled, 100% Organic Farming
    • Premium subscription box promotion
    • Compelling benefits display
  6. Footer

    • Comprehensive site navigation
    • Newsletter subscription
    • Social media links
    • Contact information
    • Trust badges

πŸš€ Bonus Features

  • βœ… Back to Top Button: Floating button for easy navigation
  • βœ… Smooth Scroll Animations: Framer Motion transitions on scroll
  • βœ… Lazy Loading Ready: Optimized for performance
  • βœ… WCAG AA Compliant: Accessible design with proper ARIA labels
  • βœ… SEO Optimized: Semantic HTML structure

πŸ› οΈ Technology Stack

  • Framework: React 19.1.1
  • Build Tool: Vite 7.x
  • Styling: Tailwind CSS 3.x
  • Animations: Framer Motion
  • Icons: Emoji-based (zero external dependencies)
  • Fonts: Google Fonts (Playfair Display, Inter)

πŸ“¦ Installation & Setup

Prerequisites

  • Node.js (v20.19.0 or higher recommended)
  • npm or yarn package manager

Quick Start

  1. Clone or navigate to the project directory

    cd foxnutS
  2. Install dependencies

    npm install
  3. Start development server

    npm run dev
  4. Open your browser

    • Navigate to http://localhost:5173
    • The app will hot-reload as you make changes

Build for Production

npm run build

The optimized production build will be in the dist folder.

Preview Production Build

npm run preview

πŸ“ Project Structure

foxnutS/
β”œβ”€β”€ public/                 # Static assets
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/        # React components
β”‚   β”‚   β”œβ”€β”€ HeroSection.jsx
β”‚   β”‚   β”œβ”€β”€ FeaturedProducts.jsx
β”‚   β”‚   β”œβ”€β”€ FarmSection.jsx
β”‚   β”‚   β”œβ”€β”€ QuizSection.jsx
β”‚   β”‚   β”œβ”€β”€ SustainabilityMeter.jsx
β”‚   β”‚   β”œβ”€β”€ Footer.jsx
β”‚   β”‚   └── BackToTop.jsx
β”‚   β”œβ”€β”€ App.jsx           # Main app component
β”‚   β”œβ”€β”€ App.css           # Component styles
β”‚   β”œβ”€β”€ index.css         # Global styles & Tailwind
β”‚   └── main.jsx          # Entry point
β”œβ”€β”€ index.html            # HTML template
β”œβ”€β”€ tailwind.config.js    # Tailwind configuration
β”œβ”€β”€ postcss.config.js     # PostCSS configuration
β”œβ”€β”€ vite.config.js        # Vite configuration
β”œβ”€β”€ package.json          # Dependencies
└── README.md            # This file

🎨 Component Overview

HeroSection.jsx

Full-screen hero with background image, headline, CTA, and four feature icons with hover effects.

FeaturedProducts.jsx

Product showcase with three cards, each featuring product image, description, price, and add-to-cart button.

FarmSection.jsx

Farm story section with location map, statistics, testimonial overlay, and farm metrics.

QuizSection.jsx

Interactive personality quiz with progress tracking, multiple-choice questions, and personalized results.

SustainabilityMeter.jsx

Environmental commitment display with animated progress bars and subscription promotion card.

Footer.jsx

Comprehensive footer with navigation links, newsletter signup, social media, and trust badges.

BackToTop.jsx

Floating button that appears on scroll, smoothly returns user to top of page.

🎯 Customization Guide

Colors

Edit tailwind.config.js to modify the color palette:

colors: {
  sage: { /* Your sage green variations */ },
  mauve: { /* Your mauve variations */ },
  cream: { /* Your cream variations */ }
}

Typography

Fonts are configured in tailwind.config.js:

fontFamily: {
  serif: ['"Playfair Display"', 'serif'],
  sans: ['"Inter"', 'sans-serif'],
}

Content

Update product data, testimonials, and text directly in component files.

🌐 Browser Support

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

β™Ώ Accessibility

  • Semantic HTML structure
  • ARIA labels on interactive elements
  • Keyboard navigation support
  • Color contrast meets WCAG AA standards
  • Focus states on all interactive elements
  • Alt text ready for images

πŸ“± Responsive Breakpoints

  • Mobile: < 768px
  • Tablet: 768px - 1024px
  • Desktop: > 1024px

πŸš€ Performance Optimizations

  • Component-based architecture for code splitting
  • Framer Motion animations with GPU acceleration
  • Optimized images (use WebP format recommended)
  • Lazy loading ready structure
  • Minimal dependencies

πŸ“„ License

This project is created for Foxnuts Farm. All rights reserved.

🀝 Contributing

This is a custom project for Foxnuts Farm. For modifications or enhancements, please contact the development team.

πŸ“ž Support

For technical support or questions:

πŸ™ Acknowledgments

  • Design inspired by modern e-commerce best practices
  • Built with love for sustainable farming and healthy snacking
  • Emoji icons for visual appeal and zero external dependencies

Built with ❀️ for Foxnuts Farm πŸͺ·

Bringing ancient superfoods to modern tables through exceptional digital experiences.

About

No description, website, or topics provided.

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published