📦 Luma Analyzer

This repository contains both the backend (Spring Boot) and frontend (React) of the Luma Analyzer project.

repo-root/
├── backend/   ← Spring Boot backend
└── frontend/  ← React frontend

---

🚀 Tech Stack

Backend

Technology	Version	Description
Java	21	Primary programming language
Spring Boot	3.5.8	Backend framework
Maven	3.9.11	Build & dependency management tool

Frontend

Technology	Version	Description
Node.js	24	JavaScript runtime
React	19.2.1	Frontend library

---

🧲 Clone & Set Up the Project (VS Code Guide)

Follow these steps to download, open, and run the project on your local machine.

📥 Clone the Repository

In your terminal, run:

git clone https://github.com/imyvj/luma.git

Then enter the project folder:

cd luma

---

🧲 Backend Setup (Springboot)

1️⃣ Install Required Tools

Make sure you have installed:

• ✅ Java 21
• ✅ Maven
• ✅ Git
• ✅ VS Code

---

Installing Java 21

On Windows

1. Go to the official Java download page and download the Windows installer (.msi file).
2. Follow the installation instructions and set the default installation path.
3. Set Environment Variables
   • Open System Properties → Advanced → Environment Variables.
   • Add JAVA_HOME to System Variables:
     • Variable Name: JAVA_HOME
     • Variable Value: (Path to Java, e.g., C:\Program Files\AdoptOpenJDK\jdk-21)
   • Add Java to the Path variable in System Variables.
4. Open a command prompt and run:

   java -version
   

On macOS

1. Using Homebrew:

   Install Java 21 with:

   brew install openjdk@21
   

2. Set the JAVA_HOME variable:

   • Add the following to your .zshrc or .bash_profile:

     export JAVA_HOME=$(/usr/libexec/java_home -v 21)
     export PATH=$JAVA_HOME/bin:$PATH
     

   • Reload your profile:

     source ~/.zshrc  # or ~/.bash_profile
     

3. Verify Installation:

   java -version
   

On Linux (Ubuntu)

1. Install Java 21:

   sudo apt update
   sudo apt install openjdk-21-jdk
   

2. Set the JAVA_HOME variable:

   • Add this to .bashrc or .zshrc:

     export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
     export PATH=$JAVA_HOME/bin:$PATH
     

   • Reload your shell:

     source ~/.bashrc  # or ~/.zshrc
     

3. Verify Installation:

   java -version
   

Installing Maven

On Windows

1. Go to the official Maven download page and download the Binary zip archive.

2. Extract the Maven archive to a directory, e.g., C:\apache-maven.

3. Set Environment Variables:

   • Add MAVEN_HOME in System Variables:

     • Variable Name: MAVEN_HOME

     • Variable Value: (Path to Maven folder, e.g., C:\apache-maven)

   • Add Maven’s bin folder to the PATH variable:

     C:\apache-maven\bin
     

4. Verify Installation: Open a new command prompt and run:

   mvn -v
   

On macOS

1. Install Maven using Homebrew:

   brew install maven
   

2. Verify Installation:

   mvn -v
   

On Linux (Ubuntu)

1. Install Maven via APT:

   sudo apt update
   sudo apt install maven
   

2. Verify Installation:

   mvn -v
   

2️⃣ Open the Project in VS Code

Option A – Using terminal:

code .

Option B – Using VS Code UI:

• Open VS Code

• Go to File → Open Folder

• Select the cloned project folder

3️⃣ Install Recommended Extensions (VS Code)

When VS Code prompts you:

This workspace recommends extensions for Java

Click Install All.

This enables:

• Spring Boot Dashboard
• Java debugger
• Maven integration

4️⃣ Build the Project

Run the following command to build the project:

cd backend
mvn clean install

5️⃣ Run the Application

From Terminal, run the following:

cd backend
mvn spring-boot:run

---

🌐 Frontend Setup (React)

1️⃣ Install Node.js & npm

• Download Node.js (includes npm) from Node.js official site
• Verify:

node -v
npm -v

---

2️⃣ Build & Run Frontend

cd frontend
npm install
npm start

Frontend will run at:

http://localhost:3000

It will auto-reload when you make changes.

---