Flexify - Wallpapers & Widgets

Table of Contents

• Why Flexify?
• Features
• Getting Started
• Community
• Screenshots
• Running from Source Code
• Built With
• Contributing
• Support
• License

Why Flexify?

Flexify is more than just a personalization app; it’s your gateway to making your phone reflect you. Whether you prefer minimalism, vibrant colors, or intricate designs, Flexify has you covered.

Features

Content & Aesthetics	User Experience
🖼️ 600+ 4K Wallpapers A massive collection for every taste.	💾 High Quality Downloads Save your favorites in full resolution.
📱 Widgets & Live Walls 100+ KWGT widgets & KLWP wallpapers.	💙 Favorites System Keep track of wallpapers or widgets you love.
🎨 Dynamic Theming Material You support with 10+ color schemes.	📋 Smart Categorization Easy navigation through organized content.
🎭 Material Design 3 Fluid animations and beautiful UI.	🌍 Multi-language Supports English, Arabic, and Hindi.

Getting Started

Download the App

Download Flexify directly from Google Play Store.

Requirements

• Android 5.0 or later.
• KWGT and KLWP apps installed (for widgets and depth wallpapers).

Community

Join our growing community on Telegram to share your setups, get inspiration, and stay updated with the latest releases:
Flexify Telegram Channel

Screenshots

Running from Source Code

Prerequisites

• Flutter SDK (3.32 recommended)
• Android Studio or VS Code with Flutter extensions
• Firebase account
• Git

Setup Instructions

1. Clone the repository

   git clone https://github.com/MAymanKH/Flexify.git
   cd Flexify

2. Install dependencies

   flutter pub get

3. Firebase Setup

   • Create a new Firebase project at Firebase Console
   • Enable Firebase Analytics and Crashlytics
   • Download google-services.json and place it in android/app/
   • Add your app's package name: com.maymanxineffable.flexify

4. API Configuration

   • Setup Flexify API to fetch content as shown in its instructions
   • Add the following API endpoints to Firebase remote configs
     • hq wallpapers endpoint as walls_hq
     • mid wallpapers endpoint as walls_mid
     • low wallpapers endpoint as walls_low
     • depth walls endpoint as depth_walls
     • widgets endpoint as widgets
     • {"X-Custom-Header": ""} as api_headers (currently empty header)
   • The API provides wallpapers, widgets, and depth wallpapers data

5. Build and Run

   # For debug build
   flutter run
   
   # For release build
   flutter build apk --release

Project Structure

• lib/src/provider/ - API integration and data providers
• lib/src/views/ - App screens and UI
• lib/src/widgets/ - Custom widgets and components
• assets/translations/ - Localization files
• android/ - Android-specific configuration

Built With

• Flutter - UI Toolkit
• Flexify API - Backend content server
• Firebase - Remote config & Analytics
• Provider - State Management
• Dio - Networking
• SQFlite - Local Database
• Dynamic Color - Material You Theming

Contributing

We welcome contributions to make Flexify even better! Here are the ways you can help:

🌍 Translation Contributions

Help us make Flexify accessible to more people by adding your language or improving existing translations.

Adding a New Language

1. Fork the repository and clone it to your local machine
2. Navigate to the translations folder: assets/translations/
3. Create a new JSON file for your language using the ISO 639-1 language code (e.g., fr.json for French, es.json for Spanish)
4. Copy the structure from en.json and translate all the values to your language
5. Test your translation by setting up and running the app, then switching to your language (optional)
6. Submit a pull request with your translation

Translation Guidelines

• Keep translations concise and natural in your language
• Maintain the same tone as the English version (friendly and professional)
• Test translations in the app to ensure they fit the UI properly (optional, but recommended)
• For technical terms (like "KWGT", "KLWP"), keep them as-is unless there's a widely accepted translation
• Use gender-neutral language where possible
• Follow your language's capitalization conventions

Support

Have questions, feedback, or issues? We’d love to hear from you! Contact us at:

• Open an Issue
• Join Telegram Discussion Group

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.