Skip to content

A beautiful web application that displays random animals from public APIs

Notifications You must be signed in to change notification settings

mcdwayne/random-animals-app

Repository files navigation

🐾 Random Animals App

A beautiful, modern web application that displays random animals from various public APIs. Discover amazing wildlife with just a click!

✨ Features

  • Random Animal Discovery: Get random animals from multiple APIs
  • Specific Animal Types: Choose between dogs, cats, and foxes
  • Beautiful UI: Modern, responsive design with smooth animations
  • Favorites System: Save your favorite animals locally
  • Statistics Tracking: Keep track of animals viewed and favorites
  • Multiple API Sources: Uses various public APIs for variety
  • Fallback System: If one API fails, automatically tries another
  • Responsive Design: Works perfectly on desktop and mobile devices

🚀 How to Use

  1. Open the Application: Simply open index.html in your web browser
  2. Get Random Animals: Click the "Get Random Animal" button for surprise animals
  3. Choose Specific Types: Use the dog, cat, or fox buttons for specific animals
  4. Save Favorites: Click on the heart icon next to animal names to save favorites
  5. View Statistics: See how many animals you've discovered and saved

🌐 APIs Used

  • Dog CEO API: For random dog images
  • The Cat API: For random cat images with breed information
  • Random Fox API: For cute fox images
  • The Dog API: Additional dog images with breed details

🛠️ Technical Details

  • Frontend: Pure HTML, CSS, and JavaScript
  • No Dependencies: No external libraries required
  • Local Storage: Favorites are saved in your browser
  • Responsive Design: CSS Grid and Flexbox for modern layouts
  • Error Handling: Graceful fallbacks if APIs are unavailable

📱 Browser Compatibility

  • Chrome (recommended)
  • Firefox
  • Safari
  • Edge
  • Mobile browsers

🎨 Design Features

  • Gradient Background: Beautiful purple-blue gradient
  • Glass Morphism: Modern translucent elements
  • Smooth Animations: Hover effects and transitions
  • Icon Integration: Font Awesome icons for better UX
  • Typography: Inter font family for clean readability

🔧 Customization

You can easily customize the application by:

  • Adding more animal APIs
  • Changing the color scheme in styles.css
  • Adding new animal types
  • Modifying the layout and animations

📁 File Structure

Animals/
├── index.html          # Main HTML file
├── styles.css          # CSS styling
├── script.js           # JavaScript functionality
└── README.md           # This file

🚀 Getting Started

  1. Download or clone the files to your local machine
  2. Navigate to the Animals directory
  3. Open index.html in your web browser
  4. Start discovering amazing animals!

🤝 Contributing

Feel free to contribute by:

  • Adding new animal APIs
  • Improving the UI/UX
  • Adding new features
  • Fixing bugs

📄 License

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


Enjoy discovering amazing animals! 🦊🐕🐱

About

A beautiful web application that displays random animals from public APIs

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published