StarKnightt/wallpaperz

StarKnightt/wallpaperz has 32 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-09 06:44 UTC. Last push 2026-11-04.

How these counts are measured

A modern, open-source wallpaper discovery and sharing platform built with Next.js, with ai image generation

32 stars 2 forks

What you can do

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

Measured star growth

in 24h: 0
in 7 days: 0
in 15 days: Update delayed
in 1 month: Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Wallpaperz

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

Features

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

Tech Stack


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	Cloudflare Workers (OpenNext)

Getting Started

Prerequisites

Node.js 18+
API keys for Clerk, ImageKit, and Stability AI (see env.example.txt)

Setup

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 dev

Open http://localhost:3000.

Environment Variables

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

Screenshots

Click to expand

Home page AI Generate page

Project Structure

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

Contributing

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.

License

MIT — see LICENSE.

Contact

Prasen — prasen.dev

Project: github.com/StarKnightt/wallpaperz