An open-source wallpaper platform where you can browse HD/4K wallpapers and generate your own with AI. Built with Next.js, powered by ImageKit and Stability AI.
Live at wallpaperz.in
- Browse and download HD & 4K wallpapers across categories (nature, anime, space, minimalist, etc.)
- Search and filter wallpapers in real time
- Generate custom 16:9 wallpapers using AI (Stable Diffusion XL) — requires sign-in
- Fullscreen preview with keyboard navigation and share links
- Dark and light mode
- Responsive — works on desktop, tablet, and mobile
- Pull-to-refresh to sync latest wallpapers from ImageKit
| Framework | Next.js 14 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS, Radix UI / shadcn |
| Animations | Framer Motion |
| Auth | Clerk |
| Images | ImageKit |
| AI Generation | Stability AI (DreamStudio) |
| Hosting | Vercel |
- Node.js 18+
- API keys for Clerk, ImageKit, and Stability AI (see
env.example.txt)
git clone https://github.com/StarKnightt/wallpaperz.git
cd wallpaperz
npm install
cp env.example.txt .env.local
# Fill in your API keys in .env.local
npm run devOpen http://localhost:3000.
See env.example.txt for the full list. The main ones:
| Variable | What it's for |
|---|---|
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY |
Clerk auth (client) |
CLERK_SECRET_KEY |
Clerk auth (server) |
IMAGEKIT_PUBLIC_KEY |
ImageKit (client) |
IMAGEKIT_PRIVATE_KEY |
ImageKit (server) |
IMAGEKIT_URL_ENDPOINT |
ImageKit URL |
DREAMSTUDIO_API_KEY |
Stability AI for image generation |
Click to expand
app/
page.tsx Home — wallpaper grid with search and filters
ai-generate/ AI image generation (Clerk-gated)
category/[slug]/ Category pages with SEO metadata
api/
wallpapers/sync/ Fetches wallpapers from ImageKit (cached 1hr)
ai-generate/ Calls Stability AI (rate-limited, 5/hr/user)
imagekit/ Client upload auth
components/ UI components (Header, WallpaperGrid, Preview, etc.)
lib/ ImageKit client/server, hooks, utils
types/ TypeScript types
- Fork the repo
- Create a branch (
git checkout -b feature/something) - Commit your changes
- Push and open a PR
All contributions are welcome — features, bug fixes, or just improving the docs.
MIT — see LICENSE.
Prasen — prasen.dev
Project: github.com/StarKnightt/wallpaperz