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. ๐
- Host: GitHub
- URL: https://github.com/rumaisas-islam/makeup-world-website
- Owner: Rumaisas-islam
- License: mit
- Created: 2025-10-06T02:46:10.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-06T03:55:02.000Z (8 months ago)
- Last Synced: 2025-10-06T05:29:37.922Z (8 months ago)
- Topics: 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
- Language: HTML
- Homepage: https://github.com/Rumaisas-islam/makeup-world-website.git
- Size: 1.71 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
๐ Makeup World Inventory App
A modern web-based inventory management system for makeup products โ built with Flask.
---
## ๐ธ 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 ๐
```