RUGE is a recipe management and sharing web application built with Spring Boot. It provides a server-rendered interface with Thymeleaf, user authentication, social features such as follows and likes, wallet/credit management, and external service integrations for vector search and AI-powered features.
- Java 21
- Spring Boot 4
- Spring Web / Spring MVC
- Spring Security
- Spring Data JPA + Hibernate
- Spring AI
- Thymeleaf + Thymeleaf Layout Dialect
- PostgreSQL
- H2 for tests
- Docker / Docker Compose
- Qdrant for vector storage
- Ollama for AI models
- Stripe for payments / credits
- create and browse recipes and variants
- manage user profiles
- likes, superlikes, and follow relationships between users / recipes
- advanced search
- wallet, credits, and transactions
- AI integration to enhance search and recommendation experiences
- admin dashboard to monitoring economy
- Java 21
- Maven
- Docker and Docker Compose if you want to run the full local stack
git clone https://github.com/RUGE-Project/ruge-backend.git
cd ruge_j2eThe project can read a .env file at the repository root. For the Docker Compose setup,
you should provide at least the following variables:
DB_USER=postgres
JWT_SECRET=change-me
QDRANT_API_KEY=change-me
STRIPE_SECRET_KEY=change-me
STRIPE_PUBLIC_KEY=change-me
PUBLIC_SERVER_HOSTNAME=localhostIf you run the application locally with the dev profile, make sure the following services
are available on their default ports:
- PostgreSQL:
5432 - Qdrant:
6334 - Ollama:
11434
docker compose up --buildThis starts:
- the Spring Boot application
- PostgreSQL
- Qdrant
- Ollama
- Stripe CLI
The application is then available at:
http://localhost:8080
If you only want to run the backend through Maven:
mvn clean install
mvn spring-boot:run -Dspring-boot.run.profiles=devNote: in this mode, make sure PostgreSQL, Qdrant, and Ollama are already running and configured.
The project statement is available here.