🌌 AthexPix - Premium Wallpaper Web Application

A beautiful, high-fidelity wallpaper platform built as a secure, fast, and feature-rich ASP.NET Core MVC web application. Originally starting as a stunning static landing page, AthexPix has been converted into a dynamic, production-ready MVC application with complete backend controls, role-based authentication, and automated local data persistence.

---

🎨 Key Features & Architecture

• 🖥️ High-Fidelity UI Design: Retains 100% of the premium visual assets, outfit fonts, sleek glassmorphism cards, purple/cyan gradients, and ultra-smooth animations.
• 📂 Automated Disk-Backed Storage: Uploaded wallpapers are securely written to the local disk (wwwroot/uploads/) with their virtual references mapped in the database.
• 🗄️ Zero-Configuration Database: Built on a modern SQLite and Entity Framework Core stack. Creating, configuring, and seeding the database is handled fully automatically at first-run!
• 🛡️ Secure Session-Based Authentication: Features standard cookie-based authentication supporting multiple distinct user roles (Admin and User).
• ⚡ Live Interactive Filters: Allows users to filter high-resolution wallpapers dynamically by custom categories or text searches instantly.
• ⚙️ Comprehensive Admin Portal: Unlocks a private suite of administrative tools for creating, updating, and cascade-deleting wallpapers and managing dynamic system categories.

---

🚀 Setup & Execution Guide (For Cloned Repositories)

Follow these simple steps to run the application locally on your machine after cloning this repository:

📋 Prerequisites

Ensure you have the following installed on your system:

• .NET 8.0 SDK (Download from dotnet.microsoft.com)
• A terminal (PowerShell, Command Prompt, or bash)
• Optional: An IDE like Visual Studio 2022, VS Code, or JetBrains Rider.

---

💻 Step-by-Step Launch Instructions

Step 1: Navigate to the Project Folder

Open your terminal and navigate to the project directory containing the .csproj file:

cd Athex-pix/AthexPix

Step 2: Restore Dependencies

Restore the required NuGet packages:

dotnet restore

Step 3: Run the Application

Start the ASP.NET Core development server:

dotnet run

---

🗄️ Database Auto-Initialization

When you run the application for the first time, Entity Framework Core will automatically:

1. Create a local SQLite database named athexpix.db inside your AthexPix/ folder.
2. Seed the 6 default wallpaper categories (Linux, Nature, Anime, Cars, Minimal, Space).
3. Populate the initial high-definition gallery with the 10 preset wallpapers included in wwwroot/uploads/.
4. Pre-configure the secure Admin accounts so you are ready to log in immediately.

---

🌐 Accessing the Application

Once the terminal outputs that the application is running, open your web browser and navigate to:

• https://localhost:5001 (Secure HTTPS)
• Or http://localhost:5000 (HTTP)

---

🔐 Seeder Administrative Accounts

The database comes pre-populated with two secure administrator accounts to make demonstration quick and effortless:

Account Type	Username	Password	Role
👑 Primary Admin	Athex	Athexdev	Administrator
👥 Secondary Admin	rohan	Rohan@123	Administrator

To test standard user workflows, simply click Sign Up on the top navigation bar to register new accounts. Newly registered users will be logged in automatically under the default User role.

---

🛠️ Admin Panel Capabilities

Once logged in as an Administrator, click Admin Panel on the navbar to perform the following:

• Add Wallpapers: Fill in a title, choose resolutions (HD/4K/8K), assign a category, and upload an image file to render it live instantly.
• Edit Wallpapers: Modify metadata, re-categorize, or swap images seamlessly.
• Delete Wallpapers: Permanently removes wallpapers from the database and automatically purges the corresponding uploaded file from wwwroot/uploads/ to optimize system disk space.
• Manage Categories: Dynamically create new wallpaper categories. Safely alerts and blocks standard deletions if they have wallpapers linked to them, or supports cascading operations.