🧥 Clothify Store

A full-featured clothing store management desktop application built with Java, JavaFX, and MySQL — designed for seamless inventory, employee, and order management.

---

📋 Table of Contents

• About the Project
• Tech Stack
• Features
• Prerequisites
• Getting Started
• Project Structure
• Database Setup
• Running the App
• License

---

📌 About the Project

Clothify Store is a desktop-based Point of Sale (POS) and store management system built for clothing retail businesses. It provides a clean, modern UI powered by JavaFX to manage products, employees, customers, and orders — all backed by a MySQL relational database.

This project was developed as part of coursework at ICET (Institute of Computer Engineering Technology).

---

🛠️ Tech Stack

Language & Platform

Technology	Version	Purpose
Java	17	Core application language
JavaFX	17.0.14	Desktop UI framework
FXML	17.0.14	Declarative UI layout

Database

Technology	Version	Purpose
MySQL	8.x	Relational database
MySQL Connector/J	8.0.33	JDBC driver for Java–MySQL connection

UI Libraries

Library	Version	Purpose
ControlsFX	11.2.1	Advanced JavaFX UI controls
Ikonli	12.3.1	Icon packs for JavaFX

Developer Tools & Utilities

Tool	Version	Purpose
Lombok	1.18.30	Boilerplate code reduction (getters, setters, constructors)
JUnit Jupiter	5.12.1	Unit testing framework
Maven	3.x	Build automation & dependency management
Maven Compiler Plugin	3.13.0	Java source compilation
JavaFX Maven Plugin	0.0.8	Run & package JavaFX apps via Maven

IDE

• IntelliJ IDEA (.idea project files included)

---

✨ Features

• 📦 Product / Inventory Management — Add, update, and remove clothing items with stock tracking
• 👥 Employee Management — Manage store staff records
• 🛒 Order & Sales Management — Process customer orders and generate receipts
• 👤 Customer Management — Maintain customer profiles and purchase history
• 🔐 User Authentication — Secure login system for staff access
• 📊 Dashboard Overview — At-a-glance store statistics and summaries
• 🎨 Modern UI — Clean JavaFX interface with icon support via Ikonli

---

✅ Prerequisites

Make sure you have the following installed before running the project:

• Java JDK 17 or higher → Download
• Maven 3.6+ → Download
• MySQL Server 8.x → Download
• IntelliJ IDEA (recommended) → Download

---

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/AmareDev2k/Clothify-store.git
cd Clothify-store

2. Configure the Database

Create a MySQL database and update your DB credentials (see Database Setup).

3. Install Dependencies

mvn clean install

4. Run the Application

mvn javafx:run

---

🗂️ Project Structure

Clothify-store/
├── src/
│   └── main/
│       ├── java/
│       │   └── edu/icet/clothifystore/
│       │       ├── controller/       # JavaFX controllers (UI logic)
│       │       ├── model/            # Entity/model classes
│       │       ├── repository/       # DB access layer (DAO)
│       │       ├── service/          # Business logic layer
│       │       └── MainApplication.java
│       └── resources/
│           └── edu/icet/clothifystore/
│               ├── view/             # FXML layout files
│               └── css/              # Stylesheets
├── .idea/                            # IntelliJ project config
├── .mvn/wrapper/                     # Maven wrapper
├── pom.xml                           # Maven build config
└── mvnw / mvnw.cmd                   # Maven wrapper scripts

---

🗄️ Database Setup

1. Open MySQL Workbench or your preferred MySQL client.
2. Create a new database:

CREATE DATABASE clothify_store;

3. Import the SQL schema file (if provided) or let the app auto-create tables on first run.
4. Update the DB connection details in your configuration file:

db.url=jdbc:mysql://localhost:3306/clothify_store
db.username=your_mysql_username
db.password=your_mysql_password

---

▶️ Running the App

Using the Maven wrapper (no Maven installation required):

Linux / macOS:

./mvnw javafx:run

Windows:

mvnw.cmd javafx:run

---

📄 License

This project is open source and available under the MIT License.

---

Built with ❤️ by AmareDev2k