WallSpace 🌌

A modern wallpaper app built with React Native — fast, smooth, and designed for a premium browsing experience.

🔥 Discover high-quality wallpapers
⚡ Smooth animations & performance
📱 Built for modern mobile devices

🚧 Actively developed and improving based on user feedback.

📥 Try the App

Currently available via Google Play Closed Testing:

👉 https://play.google.com/apps/testing/com.parag.wallspace

Note: Access requires joining the tester program.

✨ Features

• Infinite Browsing: Explore a vast collection of high-resolution wallpapers.
• Categorized Search: Find exactly what you're looking for with intuitive categories and advanced search.
• Preview & Set: Preview wallpapers in full-screen mode and set them directly to your home or lock screen.
• Personalized Favourites: Save your favorite wallpapers locally for quick access anytime.
• Offline Ready: Robust caching and network state management ensure a smooth experience even with spotty connectivity.
• Modern UI/UX: Clean design with smooth animations, haptic feedback, and intuitive navigation.

📸 Screenshots

🏠 Home Screen	🔍 Search Screen	🖼️ Viewer Screen

📁 Categories	❤️ Favourites

🎥 Demo

🏠 Home Experience	🔍 Search & Discovery

🖼️ Wallpaper Viewer	❤️ Favourites & About

🛠️ Tech Stack

• React Native (v0.84), TypeScript
• Redux Toolkit & Redux Persist
• TanStack Query
• React Navigation
• Reanimated & Vector Icons
• Haptic Feedback
• NetInfo

📂 Project Structure

src/
├── api/            # API service layers (Pexels integration)
├── components/     # Reusable UI components
├── hooks/          # Custom hooks (network, store, etc.)
├── navigation/     # Navigation configuration (Root, BottomTabs)
├── screens/        # Main application screens
│   ├── BottomTabScreens/  # Home, Favourites, Categories, Profile
│   └── ...         # Viewer, Search, Splash
├── store/          # Redux store, slices, and persistence config
├── types/          # TypeScript definitions
└── utils/          # Helper functions and constants

🚀 Getting Started

Prerequisites

• Node.js (>= 22.11.0)
• React Native Environment Setup
• Pexels API Key

Installation

1. Clone the repository

   git clone <repository-url>
   cd WallSpace
   

2. Install dependencies

   npm install
   

3. Install CocoaPods (iOS only)

   cd ios && pod install && cd ..
   

Environment Variables

Create a .env file in the root directory and add your Pexels API credentials:

API_KEY=your_pexels_api_key_here
BASE_URL=https://api.pexels.com/v1

📱 Running the App

Android

npm run android

iOS

npm run ios

Metro Bundler

npm start

---

Built with ❤️ using React Native.