Prerequisites
Before you begin, ensure you have the following installed on your system:Java 17
Required for Spring Boot backend
Maven 3.9+
Build tool for Java backend
Node.js 18+
Required for React frontend
Backend Setup
Install Dependencies
Maven will automatically download dependencies when you build:
The backend uses Spring Boot 4.0.3 with Java 17. Key dependencies include:
- Spring Boot Web for REST APIs
- Spring WebFlux for reactive WebClient
- Spring Cache with Caffeine for caching
- Lombok for reduced boilerplate
Configure Environment Variables
Create an See Environment Configuration for full details.
application.properties file or set environment variables:Frontend Setup
Install Dependencies
The frontend uses:
- React 19.2.0 for UI
- Vite 7.3.1 for fast development and building
- Axios 1.13.5 for HTTP requests
- Framer Motion 12.34.3 for animations
Verify Installation
Check Backend Health
Open your browser and navigate to:You should receive a JSON response with game data.
Common Issues
Port Already in Use
Port Already in Use
If port 5000 or 5173 is already in use:Backend: Change the port in Frontend: Vite will automatically try the next available port, or you can specify one:
application.properties:CORS Errors
CORS Errors
Ensure the
CORS_ORIGINS environment variable in the backend matches your frontend URL:Maven Build Fails
Maven Build Fails
Ensure you’re using Java 17:If not, install Java 17 and set
JAVA_HOME appropriately.Data Dragon API Timeout
Data Dragon API Timeout
If you’re experiencing timeouts, check your internet connection. The backend fetches item data from:
Next Steps
Environment Configuration
Learn about all environment variables and configuration options
Backend Architecture
Understand the Spring Boot backend structure
Frontend Architecture
Explore the React/Vite frontend architecture
Data Dragon Integration
Deep dive into API integration and caching