https://github.com/benyaminbeyzaie/slash

Slash is a wallpaper app build on top of the wallhaven.cc APIs
https://github.com/benyaminbeyzaie/slash

Last synced: about 2 months ago
JSON representation

Slash is a wallpaper app build on top of the wallhaven.cc APIs

• Host: GitHub
• URL: https://github.com/benyaminbeyzaie/slash
• Owner: benyaminbeyzaie
• Created: 2023-07-16T18:35:53.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-07-23T15:05:35.000Z (over 1 year ago)
• Last Synced: 2023-07-23T15:42:59.139Z (over 1 year ago)
• Language: Dart
• Size: 6.54 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Slash/



Slash is a simple wallpaper app.

|            Wallpapers             |             Single Wallpaper             |

| :-------------------------------: | :--------------------------------------: |

| ![Wallpapers](/screenshots/1.png) | ![Single Wallpaper ](/screenshots/2.png) |

## Decisions, Technologies and Reasons

- **Folder Architecture**: semi-clean-architecture

  Semi-Clean Architecture helps you organize your Flutter project's codebase following a variation of Clean Architecture principles. It provides a structured approach to separate business logic from presentation, making the codebase more maintainable and scalable.

- **Routing**: auto_route

  Auto Route is a powerful routing package for Flutter that simplifies the process of handling navigation in your app. The best feature is under the hood code generation and passing params between pages, Also it supports web and url params.

- **State Management**: flutter_bloc

  It facilitates the separation of UI and business logic. It uses streams to manage application state and events, making it easier to handle complex state changes and interactions.

- **Unit Test**: mocktail, flutter_test

  Mocktail is a mocking library that enables you to create mock objects for testing purposes. Combined with Flutter's built-in testing framework, flutter_test, you can efficiently write unit tests to verify the behavior of individual components in isolation. I selected both for simplicity and they take care of all of my needs.

- **UI test, Golden Test**: golden_toolkit

  Backed by eBay, Ease of use, Many features, Running on the CI. Built upon flutter test bloc and can be changed with those APIs.

- **Cache**: cached_network_image

  [Flutter official recommendation](https://docs.flutter.dev/cookbook/images/cached-images)

- **Code Quality and Linters**: flutter_lints, dart_code_metrics

  They provide predefined lint rules and static analysis tools to detect and enforce consistent coding patterns, leading to cleaner and more maintainable code.

- **Dependency Injection**: get_it

## Features

- Get list of wallpapers form api with cached iamges

- Pagination and infinite list

- See the each wallpaper in single page with more details

- Supporting Web (Specially done good work on url handling and navigation)

- Supporting iOS and Android

- Downloader feature with Progress Indicator, Saves file to the gallery, Optimized for large files and small memories (Implemented with BLoC)

- Hero animation between page changes

- Well tested page controllers and Golden tested UI

- Fully decomposed UI from Logic

- CI running pipeline for tests

- Dependency injection and abstraction on repositories

- Threshold on golden tests

- Native splash screen on every platform

- Improve user experience with Shimmers

- Throttle the unused events with throttleDroppable on fetching next page of the wallpapers

## Development

Building routes:

```bash

flutter packages pub run build_runner build

```

Running tests:

```bash

flutter test

```