Wallpaperz 🖼️

<p align="center"> <img src="https://img.shields.io/github/stars/StarKnightt/wallpaperz?style=social" alt="GitHub stars"> <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"> <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="Contributions welcome"> </p>

A beautiful, open-source wallpaper platform built with Next.js. Find and create stunning wallpapers for your devices!

✨ Features

• 🖼️ Browse high-quality wallpapers
• 🔍 Easy search and filtering
• 🌓 Light and dark mode
• 🤖 AI-powered wallpaper generation
• 📱 Fully responsive design
• 💾 Save your favorite wallpapers locally

🚀 Demo

Check out the live demo: wallpaperz.in

🛠️ Built With

• Next.js - React framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• Framer Motion - Animations
• Clerk - Authentication
• ImageKit - Image storage
• Stability AI - AI image generation

🏁 Getting Started

Prerequisites

• Node.js 18 or newer
• npm or yarn

Installation

1. Clone the repo

   git clone https://github.com/StarKnightt/wallpaperz.git
   cd wallpaperz
   

2. Install packages

   npm install
   # or
   yarn
   

3. Set up environment variables

   cp env.example.txt .env.local
   

   Then fill in your API keys in the .env.local file (see env.example.txt for required variables).

4. Start the development server

   npm run dev
   # or
   yarn dev
   

5. Open http://localhost:3000 in your browser.

📸 Screenshots

<details> <summary>Click to see screenshots</summary> <br> <p align="center"> <img src="https://ik.imagekit.io/starknight/screenshots/home.png" alt="Home page" width="80%"> <img src="https://ik.imagekit.io/starknight/screenshots/ai-generate.png" alt="AI Generate page" width="80%"> </p> </details>

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the project
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

<!-- ## ☕ Support If you find this project helpful, consider buying me a coffee! <a href="https://buymeacoffee.com/prasen" target="_blank"> <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"> </a> -->

📬 Contact

Prasen - prasen.dev

Project Link: https://github.com/StarKnightt/wallpaperz