🌸 Waifuwalls

Waifuwalls is a lightweight anime wallpaper-sharing web app built for passionate weebs and wallpaper hoarders. Powered by Flask, it offers an elegant front-end for browsing, and an admin dashboard to manage uploads.

"Waifus deserve walls. And your walls deserve waifus."

---

🌐 Website Features

• 📂 Wallpaper Serving
  Browse a curated collection of high-quality anime, fantasy, and cyberpunk wallpapers.

• 🛠️ Admin Upload Panel
  Simple, secure backend interface for uploading and organizing wallpapers into categories.

• 🚀 Lightweight Design
  Optimized for speed and simplicity — perfect for minimal-resource deployments.

---

🧰 Technologies Used

Layer	Stack
🧠 Backend	Flask (Python)
🧱 Database	Postgres (with Alembic migrations)
🎨 Frontend	HTML, CSS, JavaScript
🖼️ Assets	Static folder with categories like Anime, Cyberpunk, Fantasy, and Waifu
🛡️ Security	Flask Admin routes + environment variables
🛠 Dev Tools	Alembic, Jinja2, Python-dotenv

---

📦 Folder Structure

Waifuwalls_Ver_1/
├── run.py
├── .env / .flaskenv
├── requirements.txt
├── migrations/
├── Waifuwalls/
│   ├── __init__.py
│   ├── routes.py
│   ├── models.py
│   ├── dashboard/
│   │   └── routes.py
│   ├── templates/
│   └── static/
│       └── wallpapers/
│           ├── Anime/
│           ├── Cyberpunk/
│           ├── Fantasy/
│           ├── Religious/
│           └── Waifu/

---

🚀 How to Run Locally

# Clone the repo
git clone https://github.com/vishwassharma38/waifuwalls.git
cd waifuwalls

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set environment variables
cp .env.example .env
cp .flaskenv.example .flaskenv

# Run migrations
flask db upgrade

# Run the app
flask run
🔐 Admin Panel Access
Set your admin credentials in .env or through a login setup.
The dashboard route is typically something like /dashboard or /admin depending on your config.

📸 Categories Supported
🧝 Fantasy
🧬 Cyberpunk
💖 Waifu
📺 Anime

You can extend categories by simply uploading the wallpaper files from the admin panel!

## 📃 License

This project is licensed under a modified **MIT License**.

You are free to:
- ✅ Fork
- ✅ Modify
- ✅ Use personally or non-commercially

🚫 **Commercial use is not permitted** without written permission.  
If you wish to use this project for any commercial purpose, please contact the creator directly.

> Contact: [vishwassharma741@gmail.com] or open an issue on the GitHub repo.

💌 About the Creator
Made by Vishwas Sharma