⚙️ App Settings Manager (C++ Singleton Project)

A lightweight C++ console application that demonstrates the Singleton Design Pattern in action — managing all global application settings from a single source of truth.

---

🎯 Overview

This project simulates how a real application handles global settings through:

• ✅ A Singleton pattern for centralized configuration.
• 🎨 Styled console UI with colors, sounds, and animations.
• 💾 Persistent data storage via text-based file parsing.
• 🧠 Structured program flow through a SettingsRun class.

It’s simple, interactive, and showcases clean C++ OOP design.

---

🧠 Core Components

File	Description
AppSettings.h / .cpp	Handles all app settings logic and file parsing.
SettingsRun.h / .cpp	Controls the main app flow and user interactions.
utility.h / .cpp	Contains styled console utilities, transitions, and effects.
ConsoleFX Modules	Add beeps, colors, animations, and banners for style.

---

🖼️ Visual Showcase

🪄 1. Startup Animation

System Initialization

---

⚙️ 2. Main Menu Showcase

Overview

✏️ 3. Update Flow

Application Flow

---

🧾 4. Exit Screen

Exiting Application

---

🧩 Project Structure

AppSettings-Manager/
├── AppSettings.h
├── AppSettings.cpp
├── SettingsRun.h
├── SettingsRun.cpp
├── utility.h
├── utility.cpp
├── ConsoleStyles.h / .cpp
├── ConsoleAnimations.h / .cpp
├── ConsoleSound.h / .cpp
├── ConsoleFX.h / .cpp
└── settings.txt

---

💡 How to Run

# Compile
g++ *.cpp -o AppSettings

# Run
./AppSettings

💬 Windows users (Visual Studio):
Just open the solution, build, and run — all modules are self-contained.

---

🧰 Features

• Singleton Architecture: ensures only one global settings instance.
• Realistic File Parsing: reads settings.txt dynamically with categories.
• Animated UI: adds polish with sounds, color, and flow.
• User Interaction: update, save, and view settings directly in console.
• Modular Design: easy to expand or convert to GUI later.

---

🧠 Design Principles

• Clean Code First: readable structure over complexity.
• Minimalism: fast and clear transitions.
• Realism: mirrors real software configuration behavior.
• Scalability: ready for JSON/INI or GUI integration.

---

🛠️ Future Plans

• Add JSON-based config support (nlohmann/json).
• Add reset-to-default feature.
• GUI version using Qt or Dear ImGui.
• Save last session state automatically.
• Add undo/redo feature for edits.

---

🧑🏽‍💻 Author

Boitumelo C. Mkhondo
🎧 Deep House Producer | Future of Deep House | C++ Developer in the Making
📍 University of Limpopo
🖥️ Passionate about elegant code and visual experiences.

---

---

🚀 Final Thoughts

This project proves that console apps can have personality.
It’s a showcase of structure, style, and skill — built purely in C++.

✨ From Singleton logic to cinematic console flair, this is Belmire’s first step into full-stack and embedded systems greatness.

---