Skip to content

devpayoub/inspireflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌟 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

InspireFlow 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

About

A minimal, beautiful random quote generator built with Spring Boot and Thymeleaf.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published