🌟 InspireFlow

InspireFlow is a beautiful, minimal Spring Boot + Thymeleaf web application that delivers random inspirational quotes with every visit or interaction. Experience the power of words that motivate and inspire.

🖼️ Project Screenshot

"Where inspiration meets simplicity."

✨ Features

• 🎯 Random Quote Generation: Curated collection of motivational quotes
• ⚡ Lightning Fast: Built with Spring Boot for optimal performance
• 🎨 Modern UI: Clean, responsive design powered by Tailwind CSS
• 🔄 Instant Refresh: Get new quotes instantly with a single click
• 🔒 Privacy First: No external APIs or databases required
• 📱 Mobile Friendly: Responsive design that works on all devices

🚀 Quick Start

Prerequisites

• Java 17 or higher
• Maven 3.6 or higher

Installation & Running

# Clone the repository
git clone https://github.com/devpayoub/inspireflow.git

# Navigate to project directory
cd inspireflow

# Run the application
./mvnw spring-boot:run

Visit http://localhost:8080 in your browser to start getting inspired!

🛠 Tech Stack

• Backend: Spring Boot 3.4.5
• Template Engine: Thymeleaf
• Styling: Tailwind CSS (CDN)
• Data: JSON file storage
• Build Tool: Maven

📁 Project Structure

inspireflow/
├── src/
│   ├── main/
│   │   ├── java/dev/arghya/inspireflow/
│   │   │   ├── controller/
│   │   │   ├── model/
│   │   │   ├── service/
│   │   │   └── InspireFlowApplication.java
│   │   └── resources/
│   │       ├── templates/
│   │       │   └── index.html
│   │       └── data/
│   │           └── quotes.json
│   └── test/
├── pom.xml
└── README.md

📊 Data Format

Quotes are stored in src/main/resources/data/quotes.json:

[
  {
    "text": "The only way to do great work is to love what you do.",
    "author": "Steve Jobs"
  },
  {
    "text": "Success is not final, failure is not fatal: it is the courage to continue that counts.",
    "author": "Winston Churchill"
  }
]

🎯 Use Cases

• Daily Motivation: Start your day with inspiration
• Mindfulness Breaks: Take a moment to reflect
• Creative Inspiration: Spark new ideas
• Stress Relief: Find peace in powerful words

🤝 Contributing

We welcome contributions! Here's how you can help:

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

Adding New Quotes

To add new quotes, simply edit src/main/resources/data/quotes.json and follow the existing format.

🌟 Why InspireFlow?

"Words have the power to transform lives. InspireFlow delivers these words, one quote at a time, creating moments of reflection and motivation in our busy lives."

---

Made with ❤️ by Devpayoub