🖼️ Wallory

Wallpapers worth staring at.

Hand-picked 4K & HD wallpapers for your phone and laptop — perfectly sized for iPhone, Android, Mac, and Windows. Fresh drops every week, free to download.

🌐 Live Site · 📚 API Docs · ✨ Premium Drops

---

✨ Screenshots

Today's Premium Drop Four fresh Pro-quality wallpapers, published automatically every day at 09:00 UTC.	Browse the Library Filter by resolution, orientation, color, and category. Trending tags surface what's hot.
Curated & Editable A calm feed of abstract, nature, minimal, dark, gradient, and AI-crafted art.	Free Forever · Go Pro for 8K Unlimited HD downloads free. Upgrade to Wallory Pro for 8K originals and exclusive drops.

---

🎯 Features

• 4K / 5K / 8K wallpapers — Perfectly sized for every device
• Daily premium drops — 4 new Pro-quality wallpapers every day at 09:00 UTC
• Smart device sizing — Auto-crop for iPhone, Android, Mac, Windows, and ultrawide
• AI-crafted originals — Generated + human-curated via an internal quality pipeline
• Collections & tags — Browse by category, mood, palette, or trending tag
• Public REST API — Query wallpapers, categories, and trending data programmatically
• Pro tier — 8K originals, exclusive packs, early access, ad-free, live device preview

🧱 Tech Stack

Layer	Tech
Framework	TanStack Start v1 (SSR) + React 19
Build	Vite 7
Styling	Tailwind CSS v4 (native @import + design tokens)
Backend	Lovable Cloud (Postgres + Auth + Storage + Edge)
AI Pipeline	Multi-provider router (Lovable AI, Gemini, OpenRouter, NVIDIA)
Payments	Razorpay
Hosting	Cloudflare Workers (edge)

🗂️ Project Structure

src/
├─ routes/              File-based routing (TanStack Router)
│  ├─ index.tsx         Landing page
│  ├─ browse.tsx        Wallpaper gallery
│  ├─ premium.daily.tsx Daily premium drop
│  ├─ _authenticated/   Auth-gated pages (upload, admin, profile)
│  └─ api/public/       Webhooks, cron hooks, public REST API
├─ components/          Reusable UI (Navbar, ProtectedImage, LibraryMockup…)
├─ lib/                 Server functions (*.functions.ts) + server-only helpers (*.server.ts)
├─ integrations/        Backend clients (auto-generated — do not edit)
└─ styles.css           Tailwind v4 tokens & keyframes

🚀 Getting Started

bun install
bun run dev          # http://localhost:8080

Other scripts:

bun run build        # Production build
bun run typecheck    # tsgo strict typecheck
bun run test         # Vitest unit tests
bunx playwright test # e2e smoke tests

🔌 Public API

A small REST surface lives under /api/public/v1/*:

• GET /api/public/v1/wallpapers — paginated list
• GET /api/public/v1/wallpapers/:slug — single wallpaper
• GET /api/public/v1/categories — categories index
• GET /api/public/v1/search?q=… — text search
• GET /api/public/v1/trending — trending picks

Full reference: /api-docs

🤖 Daily Premium Pipeline

Every day at 09:00 UTC a cron hook drops 4 fresh premium wallpapers:

1. Prompt library picks weighted templates per category
2. AI router generates images across configured providers
3. Quality evaluator rejects low-scoring outputs
4. Optimizer produces device-sized variants (phone, laptop, ultrawide)
5. Publisher attaches metadata, tags, and notifies subscribers

Hooks live under src/routes/api/public/hooks/.

🔒 Security

• Row Level Security on every public table
• Watermarked previews for premium wallpapers via ProtectedImage
• Short-lived signed URLs for downloads
• Cloudflare Turnstile on public forms
• Rate-limited download endpoints (10 / 5 hours per user)

📜 License

© Wallory. All wallpapers are the property of their respective creators.

---

Built with ❤️ on Lovable.