Skip to main content
Full-Stack E-Commerce Platform

​
Welcome to Iquea Commerce

A modern, production-ready e-commerce solution built with React, Spring Boot, and MySQL. Designed for furniture retail with complete order management, JWT authentication, and role-based access control.

Get Started →API Reference

​
What is Iquea Commerce?

Iquea Commerce is a comprehensive e-commerce platform specifically designed for furniture retail businesses. It provides a complete solution with a modern React frontend, robust Spring Boot backend, and MySQL database - all working together to deliver a seamless shopping experience. The platform handles everything from product catalog management and search functionality to shopping cart operations, order processing, and inventory management. With built-in JWT authentication and role-based access control, it supports both customer and administrator workflows out of the box.

​
Key Features

JWT Authentication

Secure token-based authentication with Spring Security and role-based access control for Admin and Customer roles

Product Catalog

Full-featured product management with categories, search, filtering by price range, and featured product highlighting

Shopping Cart & Checkout

Complete shopping cart functionality with real-time stock validation and streamlined checkout process

Order Management

Track orders through their lifecycle with status updates, order history, and reference code generation

Admin Panel

Powerful admin interface for managing products, categories, inventory, and viewing all orders

RESTful API

Well-documented REST API with full CRUD operations for products, categories, orders, and users

​
Technology Stack

Iquea Commerce is built with modern, production-tested technologies:
  • React 19 - Modern UI library with hooks and functional components
  • TypeScript 5 - Type-safe development with full IDE support
  • Vite 7 - Lightning-fast build tool and dev server
  • React Router 7 - Client-side routing with nested routes
  • Pure CSS - Custom styling without framework dependencies

​
Architecture Overview

The application follows a decoupled client-server architecture:
  • Frontend: Single-page application (SPA) built with React and TypeScript, running on Vite dev server
  • Backend: RESTful API with Spring Boot handling business logic, authentication, and data persistence
  • Database: MySQL database storing users, products, categories, orders, and order details
All API communication is secured with JWT tokens, and role-based access control ensures proper authorization for admin and customer operations.

​
Quick Start

Get up and running in minutes:
1

Prerequisites

Install Java 21, Node.js 18+, and MySQL 8.0+
2

Clone Repository

git clone https://github.com/MateoCastro47/Iquea_Commerce.git
cd Iquea_Commerce
3

Setup Database

CREATE DATABASE IF NOT EXISTS apiIquea CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
4

Start Backend

cd Iqüea_back
./mvnw spring-boot:run
Backend will run on http://localhost:8080
5

Start Frontend

cd Iquea_front
npm install
npm run dev
Frontend will run on http://localhost:5173
Default test accounts are available: admin / password123 (Admin role) and maria123 / password123 (Customer role)

​
Next Steps

Complete Setup Guide

Follow the detailed installation and configuration guide

Architecture Deep Dive

Learn about the system architecture and design patterns

Frontend Development

Explore the React frontend structure and components

Backend Development

Understand the Spring Boot backend architecture

Build docs developers (and LLMs) love

Get started for freeTalk to us