Screeny is an open-source wallpaper application built using modern Android development technologies. This project demonstrates a clean and scalable implementation for fetching and displaying wallpapers with an interactive UI.
- Jetpack Compose: Leverages Compose for a modern and declarative UI.
- Pager3: Implements smooth pagination for wallpapers.
- Ktor: Handles lightweight and scalable network requests.
- Coil: Ensures fast and efficient image loading.
- Open Source: Contributions and feature suggestions are encouraged!
Follow these steps to set up and run the project locally.
Make sure you have the following installed:
- Android Studio Electric Eel or later
- JDK 17 or higher
- Git
-
Fork the Repository
- Click on the Fork button on the top right of the repository page to create a copy under your GitHub account.
-
Clone the Repository
git clone https://github.com/<your-username>/Screeny-Compose.git cd Screeny-Compose
-
Open the Project
- Launch Android Studio and select Open an Existing Project.
- Navigate to the cloned directory and open it.
-
Build and Run
- Sync the Gradle files.
- Connect a device or start an emulator and run the app.
Contributions are welcome! Follow these steps to add new features or fix bugs:
-
Create a Feature Branch
git checkout master git checkout -b feature/new-feature-name
-
Implement Your Changes
- Make your modifications to the codebase.
-
Test Your Changes
- Ensure your changes work as intended by running the app.
-
Commit and Push
git commit -m "Added feature: [description of the feature]" git push origin feature/new-feature-name -
Create a Pull Request
- Open the original repository on GitHub.
- Click Pull Requests and then New Pull Request.
- Submit your pull request with a description of your changes.
This project is open-source and thrives on community input. Feel free to:
- Open issues for bug reports or feature suggestions.
- Fork the repository and submit pull requests with improvements.
This project is licensed under the MIT License.