Skip to content

Sourojitbanerjee/World-Cuisine-Explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ World Cuisine Explorer

A beautiful, interactive web application that showcases cuisines from around the world with real-time search functionality and detailed dish information.

๐Ÿš€ Features

๐Ÿฝ๏ธ Comprehensive Cuisine Database

  • 20+ Global Cuisines including Italian, Japanese, French, Chinese, Indian, Mexican, Thai, and many more
  • 100+ Famous Dishes with authentic names and regional specialties
  • Cultural Context with descriptions of each cuisine's characteristics and influences

๐Ÿ” Smart Search System

  • Real-time Search - Results update as you type
  • Flexible Matching - Search by country name, cuisine type, or dish characteristics
  • Case-insensitive - Works with any capitalization
  • No Results Handling - Elegant messaging when no matches are found

๐ŸŽจ Modern Design

  • Glassmorphism UI with frosted glass effects and backdrop blur
  • Responsive Layout that works on desktop, tablet, and mobile devices
  • Smooth Animations including hover effects and card transitions
  • Interactive Elements with scaling effects and visual feedback
  • Beautiful Gradients and modern color schemes

๐Ÿ› ๏ธ Technologies Used

  • HTML5 - Semantic markup and structure
  • CSS3 - Advanced styling with modern features:
    • Flexbox and CSS Grid for layout
    • CSS Transforms and Transitions
    • Backdrop filters and glassmorphism effects
    • Responsive design with media queries
  • Vanilla JavaScript - Interactive functionality:
    • Dynamic content generation
    • Real-time search filtering
    • Event handling and DOM manipulation

๐Ÿ“ Project Structure

world-cuisine-explorer/
โ”œโ”€โ”€ index.html          # Main HTML file with embedded CSS and JavaScript
โ””โ”€โ”€ README.md          # Project documentation

๐Ÿš€ Getting Started

Prerequisites

  • Any modern web browser (Chrome, Firefox, Safari, Edge)
  • No additional software or dependencies required

Installation & Usage

  1. Download the project

    # Clone or download the HTML file
    wget [your-file-url] -O index.html
  2. Open in browser

    # Simply open the HTML file in your preferred browser
    open index.html
    # or double-click the file in your file explorer
  3. Start exploring!

    • Browse through different world cuisines
    • Use the search bar to find specific countries or dishes
    • Click on dish tags to see interactive effects

๐Ÿ” Search Examples

Search Term Results
Italian Shows Italian cuisine with Pizza, Pasta, Risotto, etc.
spicy Displays cuisines known for spicy food (Thai, Indian, Mexican)
noodles Shows Asian cuisines featuring noodle dishes
curry Highlights Indian, Thai, and other curry-based cuisines
rice Displays cuisines where rice is a staple ingredient

๐ŸŒŸ Cuisine Coverage

European

  • ๐Ÿ‡ฎ๐Ÿ‡น Italian - Pizza, Pasta, Risotto, Gelato
  • ๐Ÿ‡ซ๐Ÿ‡ท French - Croissant, Coq au Vin, Crรจme Brรปlรฉe
  • ๐Ÿ‡ช๐Ÿ‡ธ Spanish - Paella, Tapas, Gazpacho
  • ๐Ÿ‡ฌ๐Ÿ‡ท Greek - Moussaka, Gyros, Baklava
  • ๐Ÿ‡ฉ๐Ÿ‡ช German - Bratwurst, Schnitzel, Pretzels
  • ๐Ÿ‡ท๐Ÿ‡บ Russian - Borscht, Beef Stroganoff, Blini

Asian

  • ๐Ÿ‡ฏ๐Ÿ‡ต Japanese - Sushi, Ramen, Tempura
  • ๐Ÿ‡จ๐Ÿ‡ณ Chinese - Dim Sum, Peking Duck, Hot Pot
  • ๐Ÿ‡ฎ๐Ÿ‡ณ Indian - Curry, Biryani, Tandoori Chicken
  • ๐Ÿ‡น๐Ÿ‡ญ Thai - Pad Thai, Tom Yum, Green Curry
  • ๐Ÿ‡ฐ๐Ÿ‡ท Korean - Kimchi, Bulgogi, Korean BBQ
  • ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese - Pho, Banh Mi, Spring Rolls

Middle Eastern & African

  • ๐Ÿ‡ฑ๐Ÿ‡ง Lebanese - Hummus, Tabbouleh, Falafel
  • ๐Ÿ‡น๐Ÿ‡ท Turkish - Dรถner Kebab, Turkish Delight
  • ๐Ÿ‡ฒ๐Ÿ‡ฆ Moroccan - Tagine, Couscous, Mint Tea
  • ๐Ÿ‡ช๐Ÿ‡น Ethiopian - Injera, Doro Wat, Ethiopian Coffee

Americas

  • ๐Ÿ‡ฒ๐Ÿ‡ฝ Mexican - Tacos, Guacamole, Enchiladas
  • ๐Ÿ‡ง๐Ÿ‡ท Brazilian - Feijoada, Churrasco, Aรงaรญ Bowl
  • ๐Ÿ‡ต๐Ÿ‡ช Peruvian - Ceviche, Lomo Saltado
  • ๐Ÿ๏ธ Caribbean - Jerk Chicken, Rice and Peas

๐ŸŽจ Design Philosophy

Visual Hierarchy

  • Clear typography with appropriate font sizes and weights
  • Color coding with vibrant gradients for interactive elements
  • Spacing and layout that guides the user's eye naturally

User Experience

  • Intuitive search that responds immediately to user input
  • Visual feedback for all interactive elements
  • Responsive design that works across all device sizes
  • Accessibility considerations with proper contrast and semantic markup

Performance

  • Single file architecture for easy deployment and fast loading
  • Efficient DOM manipulation with minimal JavaScript overhead
  • CSS animations using hardware acceleration for smooth performance

๐Ÿ“ฑ Browser Compatibility

  • โœ… Chrome 60+
  • โœ… Firefox 55+
  • โœ… Safari 12+
  • โœ… Edge 79+
  • โœ… Mobile browsers (iOS Safari, Chrome Mobile)

๐Ÿ”ง Customization

Adding New Cuisines

To add a new cuisine, edit the cuisines array in the JavaScript section:

{
    name: "New Cuisine",
    flag: "๐Ÿณ๏ธ",
    description: "Description of the cuisine...",
    dishes: ["Dish 1", "Dish 2", "Dish 3", ...]
}

Styling Changes

  • Modify CSS variables for consistent color theming
  • Adjust animation durations in the transition properties
  • Update responsive breakpoints in media queries

Search Enhancement

  • Add more search keywords to the filtering logic
  • Implement category-based filtering
  • Add sorting functionality

๐Ÿค Contributing

Contributions are welcome! Here are some ways you can help:

  • Add more cuisines from underrepresented regions
  • Improve search functionality with more intelligent matching
  • Enhance visual design with new animations or layouts
  • Optimize performance for faster loading times
  • Add accessibility features for better inclusivity

๐Ÿ“„ License

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

๐Ÿ™ Acknowledgments

  • Cuisine information compiled from various culinary resources
  • Flag emojis provided by Unicode Consortium
  • Design inspiration from modern web design trends
  • Special thanks to food enthusiasts worldwide for cultural authenticity

๐Ÿ“ž Support

If you encounter any issues or have suggestions for improvement:

  • Check the browser console for error messages
  • Ensure you're using a supported browser version
  • Try refreshing the page or clearing browser cache

Enjoy exploring the delicious world of global cuisine! ๐Ÿดโœจ

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published