Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alphasp/pxview

An unofficial Pixiv app client for Android and iOS, built with React Native.
https://github.com/alphasp/pxview

pixiv react react-native

Last synced: 4 months ago
JSON representation

An unofficial Pixiv app client for Android and iOS, built with React Native.

Host: GitHub
URL: https://github.com/alphasp/pxview
Owner: alphasp
License: mit
Created: 2017-07-10T05:28:08.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-04-14T10:11:11.000Z (10 months ago)
Last Synced: 2024-05-02T05:51:35.327Z (10 months ago)
Topics: pixiv, react, react-native
Language: JavaScript
Homepage:
Size: 97.5 MB
Stars: 720
Watchers: 46
Forks: 85
Open Issues: 62
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # PxView

![logo](./src/images/logo.png)

[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg)](https://github.com/prettier/prettier)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/alphasp/pxview/pulls)

PxView also know as PxView R is an unofficial Pixiv app client for Android and iOS, built with React Native.

## Screenshots

![android_recommended](./screenshots/android/1.png)

![android_search](./screenshots/android/2.png)

![android_detail](./screenshots/android/3.png)

![ios_illust_ranking](./screenshots/ios/1.png)

![ios_recommended](./screenshots/ios/2.png)

## Features

- Bottom navigation

- Ranking

	- Enjoy the latest popular works.

 	- Find trending works over the past day, week, or month.

- New Works

 - Check out new works from the users you're following.

 - View new works from your friends or all pixiv users

- Search

	- Search for your favourite works with keyword.

 	- Search for popular titles or characters.

 	- Search illustrations/novels by tags, titles or id.

 	- Search for users.

 	- View the latest trends on pixiv with "Featured Tags"

- One tap button to save multiple images

- Mute and highlight tags (New in version 1.6)

- Tag Encyclopedia (New in version 1.6)

- Support localization (English, Japanese, Chinese)

- Ad free

## Download 



## Getting Started

1. `$ git clone https://github.com/alphasp/pxview`

2. `$ npm install`

3. `$ npm run pod-install`

4. Set up Firebase account on [Firebase](https://console.firebase.google.com/). 

	- Create a new project, and enable Google Analytics

	- [Android] Add android app on firebase console, download `google-services.json` and move to `/android/app` folder

	- [iOS] Add iOS app on firebase console, download `GoogleService-Info.plist` and move to `/ios` folder

	- (Optional) In app feedback feature: Create Realtime Database from firebase console and enable rules to write to `feedback`

5.	Run the app

	- [Android] `$ npm run android`

	- [iOS] `$ npm run ios`

## Application Architecture

- [redux](https://github.com/reactjs/redux) is a predictable state container for JavaScript apps, 

- [redux-saga](https://github.com/yelouafi/redux-saga/) is a library that aims to make side effects (i.e. asynchronous things like data fetching and impure things like accessing the browser cache) in React/Redux applications easier and better.

- [redux-persist]() is use to persist and rehydrate a redux store. It is use in this project to persist redux store in react-native `AsyncStorage` and rehydrate on app start.

- [react-navigation](https://github.com/react-community/react-navigation) is the official react-native navigation solution. It is extensible yet easy-to-use

- [react-native-paper](https://github.com/callstack/react-native-paper) is a Material Design library for React Native (Android & iOS)

- [react-native-localization](https://github.com/stefalda/ReactNativeLocalization) is a library to localize the ReactNative interface

- [react-native-firebase](https://github.com/invertase/react-native-firebase) is a A well-tested feature-rich modular Firebase implementation for React Native. Supports both iOS & Android platforms for all Firebase services. It is use in this project for crash reporting and analytics.

- [normalizr](https://github.com/paularmstrong/normalizr) normalizes nested JSON according to a schema

- [reselect](https://github.com/reactjs/reselect) is a selector library for Redux that is efficient and can compute derived data, allowing Redux to store the minimal possible state.

- And more..

## Tests

```

$ npm test

```

## Related Projects

[pixiv-api-client](https://github.com/alphasp/pixiv-api-client) - Api client for Pixiv

## Contribute

1. Fork [pxview](https://github.com/alphasp/pxview)

2. Follow steps in Getting Started to install dependencies and setup.

3. Make your code changes

4. `npm run lint` to lint and prettify codes, make sure all eslint warning and errors are fixed.

5. `npm test` to run test, make sure all tests are passed.

6. Commit and push your codes, then create a pull request.

## Donations

If you like this application and think it is useful, you may consider making a donation

### Amazon eGift Card (Amazon US or Amazon Japan)

Send to [email protected] via email delivery option

### Paypal

[![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.me/hkkuah)

### Github Sponsors

[![github_sponsors](./donations/github_sponsor.png)](https://github.com/sponsors/alphasp)

### Bitcoin

![btc](./donations/btc.png)

34nfe2Jm8Tg8f8YfE4Vk12JGeXDqC4b5pU

## License

MIT