☕ Production-grade Java 25 / Spring Boot 4 backend for a coffee marketplace.
🚀 A real-world learning project with authentication, catalog, cart, orders, payments, reviews, file storage, observability, and cloud-ready infrastructure.
🌐 Live Demo · 🚀 Getting Started · 📖 API Specs · 🟢 Good First Issues · 💬 Community
Live application interface
Iced Latte is not just a demo repository. It has been noticed by developers, contributors, mentors, tooling companies, and engineering communities.
| Recognition | Why it matters | Proof |
|---|---|---|
| 1. 🔥 GitHub Trending May 22, 2024 |
The backend repository reached GitHub Trending and gained 85 stars in one day with 27 active contributors. | Archive |
| 2. 🥉 KaiCode 2024 Finalist Developer festival selection |
Selected among 412 applications for a developer festival backed by Huawei. | KaiCode 2024 |
| 3. 🛠️ JetBrains Tooling Support Contributor tooling support |
JetBrains granted 8 All Products Pack licenses to support contributors. | JetBrains OSS |
| 4. 👨💻 Recommended by a GitHub Star Community endorsement |
Publicly recommended as a strong Java project example, with contributors sharing their experience. | LinkedIn post |
⭐ These milestones show that Iced Latte is a real collaborative engineering project, not a toy example.
Iced Latte is a non-profit sandbox project started in 2022 as a private pet project. It was later opened to the community to give junior engineers, students, and mentees practical experience in a real tech project with processes similar to those in actual tech teams. The first participants were students, Telegram channel subscribers, and mentees from ADPList and Women In Tech. The project has since grown and earned recognition from the wider developer community.
⭐ If this project helps you learn or inspires you, please give it a star — it means a lot to the community!
Iced Latte is split into three focused repositories so contributors can work on backend, frontend, or QA independently.
| Repository | What it contains | Best for | Stats |
|---|---|---|---|
| 🔧 Backend | Java 25, Spring Boot 4, PostgreSQL, Redis, MinIO, Stripe, OpenAPI | Backend engineers, Java learners, API contributors |   |
| 🎨 Frontend | Customer-facing marketplace web application | Frontend engineers, UI contributors, React learners |   |
| 🧪 QA | Test automation, quality workflows, end-to-end coverage | QA engineers, test automation learners, release-quality contributors |   |
⭐ If this project helps you learn or inspires you, please give it a star — it helps more contributors discover the ecosystem.
📖 New here? Start with the Getting Started Guide.
It explains every step slowly: what to install, how to run the backend, how to use IntelliJ, how to run Docker, how to connect the frontend, and what to do when something fails.
✅ You need these installed first:
- Java 25
- Maven 3.9+
- Docker Desktop
⚡ Already comfortable with the terminal? Use the short path:
git clone https://github.com/Sunagatov/Iced-Latte.git
cd Iced-Latte
docker compose --env-file .env.example up -d postgres redis minio minio-init
set -a && source .env.example && set +a && mvn spring-boot:run🪟 On Windows PowerShell / CMD, do not copy the last command blindly. Use the Getting Started Guide instead.
🩺 Health: http://localhost:8083/actuator/health
📚 Swagger UI: http://localhost:8083/api/docs/swagger-ui/index.html
🧪 Run the tests:
mvn test✅ Tests use Testcontainers — Docker must be running.
| Category | Technologies |
|---|---|
| 💻 Core backend | Java 25, Spring Boot 4.0.6, Spring Framework 7, Maven |
| 🏗️ Application framework | Spring Web, Spring Security, Spring Data JPA, Spring Retry, Spring Actuator |
| 🗄️ Data layer | PostgreSQL, Liquibase, Redis, Caffeine |
| 🔒 Authentication & security | JWT with JJWT 0.13, Google OAuth2, Argon2, Bouncy Castle |
| ☁️ Storage & cloud | AWS S3 SDK 2.x, CloudFront, MinIO |
| 💳 Payments | Stripe |
| 🤖 AI features | LangChain4j, OpenAI-compatible APIs |
| 📋 API contract | OpenAPI 3, SpringDoc 3.0, OpenAPI Generator 7 |
| 📊 Observability | Micrometer, Prometheus, OpenTelemetry, Sentry, Loki, Datadog |
| 🧪 Testing & quality | JUnit 5, Testcontainers, REST Assured, Instancio, Jacoco, SonarCloud, Codecov |
| 🔄 Code generation & mapping | MapStruct 1.6, Lombok |
- 📄 Getting Started — all four local run modes, IDE setup, Docker-only mode, troubleshooting
- 📄 Infrastructure — how the database, object storage, and Redis cache are wired together, with free-tier provider options and env vars explained
- 📄 Architecture: Feature Packaging — modular-monolith rule: keep business code inside its owning feature package
- 📄 Contributing — how to contribute, PR guidelines, branching
- 📄 Security Policy — security policy and vulnerability reporting
- 📄 Code of Conduct — community standards and expected behavior
- 📄 LICENSE — Iced Latte Personal Evaluation License 2026
src/main/java/com/zufar/icedlatte/
├── 🔒 security/ # JWT auth, Google OAuth2, registration, login, sessions, rate limiting
├── 🔑 auth/ # Google OAuth2 callback, auth redirects
├── 👤 user/ # User profile, addresses, avatars
├── 📦 product/ # Product catalog, filters, images
├── 🛒 cart/ # Shopping cart
├── 📋 order/ # Orders, order lifecycle, order history
├── 💳 payment/ # Stripe payment, checkout, webhooks
├── ⭐ review/ # Product reviews, ratings, AI moderation
├── ❤️ favorite/ # Favorites list
├── 📧 email/ # Email verification & notifications
├── 📁 filestorage/ # AWS S3 / MinIO file upload/download
├── 🔧 common/ # Shared utilities, validation, monitoring, HTTP helpers
└── 🚀 astartup/ # Startup data migration and bootstrap tasks
Iced Latte is built in the open and welcomes contributors who want practical experience with a real Java/Spring Boot codebase.
| I want to... | Start here |
|---|---|
| 🟢 Make my first contribution | Pick a good first issue and comment "I'm on it" |
| 🐛 Report a bug | Open an issue with clear observed vs expected behavior |
| 💡 Suggest a feature | Start a Discussion before implementation |
| 🔧 Make a larger change | Comment on the issue first so hidden constraints can be clarified |
Before opening a PR:
- 🎯 Keep the change focused on one concern
- ✅ Run
mvn test - 🔗 Reference the related issue
- 📖 Read the full Contributing Guide
⚠️ By contributing, you agree to the project license and contribution terms described in CONTRIBUTING.md and LICENSE.
📜 Iced Latte Personal Evaluation License 2026 — personal local evaluation only.
Commercial use, remote hosting, publication, redistribution, sublicensing, forks, mirrors, derivative repositories, educational use, public presentation, and any transfer or sharing of the repository material or derivatives require prior written permission signed by the author and legally verified as required by the author.
- 💬 Telegram community: Project community
- 👤 Personal Telegram: @lucky_1uck
- 📱 WhatsApp: Message me
- 📧 Email: zufar.sunagatov@gmail.com
- 🐛 Issues: GitHub Issues
❤️