Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

devpayoub/inspireflow

Open more actions menu

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
Morty Proxy This is a proxified and sanitized view of the page, visit original site.