💬 Quote Generator 🌟

✨ Inspirational Quotes at Your Fingertips

Beautiful, interactive web application for generating and sharing inspirational quotes

---

✨ Project Description

This project is a beautiful and interactive web application that generates inspirational quotes from famous authors and personalities. It features a clean, modern design with responsive layout and provides users with the ability to get new quotes, copy them to clipboard, and share them on various social media platforms.

---

🔧 Key Features

📝 Quote Display

• Beautiful, centered quote container with elegant typography
• Displays inspirational quotes with author attribution
• Automatic loading of quotes on page load

🔄 New Quote Generation

• "New Quote" button to fetch fresh inspirational content
• Integration with ZenQuotes API for real-time quote fetching
• Fallback system with curated quotes when API is unavailable

📋 Copy to Clipboard

• One-click copy functionality for easy sharing
• Visual feedback with success notification
• Handles both modern and legacy browser compatibility

📱 Social Media Sharing

• Share quotes on Twitter, Facebook, and WhatsApp
• Web Share API support for mobile devices
• Custom sharing modal with multiple platform options

🎨 Responsive Design

• Mobile-first approach with responsive breakpoints
• Elegant typography using Google Fonts (Playfair Display)
• Beautiful card-based layout with subtle shadows
• Font Awesome icons for enhanced user experience

⚡ Smart Rate Limiting

• Built-in rate limiting to prevent API abuse
• Automatic fallback to local quotes when rate limited
• Seamless user experience even during API restrictions

---

🛠️ Technologies Used

---

⚙️ Installation Steps

📥 Clone the repository

git clone https://github.com/bouglacemarouane/QuoteGenerator.git

📂 Navigate to the project folder

cd QuoteGenerator

📦 Install dependencies

npm install

🌐 Start the server

node server.js

🚀 Access the application

Open your browser and navigate to:

• Frontend: http://localhost:3000 (or open index.html directly)
• API Endpoint: http://localhost:3000/api/quote

---

📷 Screenshots

🏠 Clean, centered design with quote display and action buttons.

---

🔧 API Endpoints

GET /api/quote

Returns a random inspirational quote in JSON format.

Response Format:

[
  {
    "q": "The only way to do great work is to love what you do.",
    "a": "Steve Jobs"
  }
]

---

🤝 Contributing

Contributions to this project are welcome! If you have suggestions, improvements, or bug fixes, please submit a pull request. Make sure to follow coding conventions and maintain consistent styles.

If you encounter issues or want to request a new feature, please open an issue in the repository with as much detail as possible.

Ways to Contribute

• 🐛 Report Bugs - Found an issue? Let us know!
• 💡 Suggest Features - Have ideas? We'd love to hear them!
• 🔧 Submit Pull Requests - Code contributions are welcome
• 📖 Improve Documentation - Help make our docs better

Getting Started

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

⭐ Support

If you like this project, don't forget to leave a ⭐ on GitHub. Thank you and happy coding! 🚀

---

📬 Stay in Touch

👨‍💻 Marouane Bouglace - Project Creator

---

Thank you for visiting Quote Generator! 💬✨