An open API service indexing awesome lists of open source software.

https://github.com/rumaisas-islam/makeup-world-website

A modern, elegant Makeup Inventory Management Web App built with Flask โ€” manage your beauty products, brands, and stock effortlessly. ๐Ÿ’…
https://github.com/rumaisas-islam/makeup-world-website

beauty cosmetic-inventory cosmetics flask flask-project flask-website full-stack-flask-project inventory-management inventory-system makeup makeup-management-system makeup-world-website python python-flask-app sqlite web-app web-development

Last synced: about 1 month ago
JSON representation

A modern, elegant Makeup Inventory Management Web App built with Flask โ€” manage your beauty products, brands, and stock effortlessly. ๐Ÿ’…

Awesome Lists containing this project

README

          


Makeup World Banner

๐Ÿ’„ Makeup World Inventory App


A modern web-based inventory management system for makeup products โ€” built with Flask.



Stars


Issues

Flask
Python
License

---

## ๐ŸŒธ Overview
**Makeup World** is a lightweight inventory management web app designed for beauty stores and product managers to manage makeup products effortlessly.
It provides a **login system**, **product CRUD operations**, and a **beautiful interface** for managing items by category, brand, and stock.

---

## ๐Ÿง  Features
โœ… Secure Admin Login
โœ… Add / Edit / Delete Products
โœ… Product Listing with Details
โœ… SQLite Database Integration
โœ… Fully Tested with Pytest
โœ… Clean & Modern UI

---

## ๐Ÿ—‚๏ธ Folder Structure
```

makeup-world-website/
โ”œโ”€โ”€ app.py
โ”œโ”€โ”€ requirements.txt
โ”œโ”€โ”€ models.py
โ”œโ”€โ”€ makeup.db
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ banner.png
โ”œโ”€โ”€ static/
โ”‚ โ”œโ”€โ”€ style.css
โ”‚ โ””โ”€โ”€ uploads/
โ”œโ”€โ”€ templates/
โ”‚ โ”œโ”€โ”€ base.html
โ”‚ โ”œโ”€โ”€ index.html
โ”‚ โ”œโ”€โ”€ login.html
โ”‚ โ”œโ”€โ”€ add_product.html
โ”‚ โ”œโ”€โ”€ edit_product.html
โ”‚ โ””โ”€โ”€ products.html
โ”œโ”€โ”€ tests/
โ”‚ โ”œโ”€โ”€ test_app.py
โ”‚ โ””โ”€โ”€ **init**.py
โ””โ”€โ”€ sample_output/
โ””โ”€โ”€ products_sample.json

```

---

## โš™๏ธ Installation

### 1๏ธโƒฃ Clone the repository
```bash
git clone https://github.com/Rumaisas-islam/makeup-world-website.git
cd makeup-world-website
````

### 2๏ธโƒฃ Create and activate a virtual environment

```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```

### 3๏ธโƒฃ Install dependencies

```bash
pip install -r requirements.txt
```

### 4๏ธโƒฃ Run the app

```bash
python app.py
```

Then open **[http://127.0.0.1:5000/](http://127.0.0.1:5000/)** in your browser ๐ŸŽ€

---

## ๐Ÿงช Running Tests

The app includes unit tests for all key features.

```bash
pytest -v --disable-warnings
```

---

## ๐Ÿ’พ Admin Login

| Field | Default Value |
| ------------ | ------------- |
| **Username** | `admin` |
| **Password** | `1234` |

---

## ๐Ÿ“ธ Preview

*(Add screenshots of your app UI here later)*

---

## ๐Ÿ› ๏ธ Built With
- **Flask** โ€“ Backend framework
- **SQLite** โ€“ Lightweight database
- **HTML5 / CSS3** โ€“ Frontend
- **Pytest** โ€“ Testing

## ๐Ÿ‘ฉโ€๐Ÿ’ป Author

**[Rumaisa Islam](https://github.com/Rumaisas-islam)**
โœจ Passionate about clean design, modern web apps, and creative UI/UX.

---

## ๐Ÿ“œ License

This project is licensed under the **MIT License**.
Feel free to modify and use it for your personal or commercial projects.

---

Made with โค๏ธ by Rumaisa Islam ๐Ÿ’…


```