stuhome

stuhome copied to clipboard

What

An iOS client for https://bbs.uestc.edu.cn/ written in react-native, redux and redux-observable, which has been recommended officially as one of the best 3rd party iOS clients.

APIs are provided by appbyme/mobcent-discuz and partly documented by UESTC-BBS/API-Docs.

Status (v1.7.3)

Screenshot

Features

• [x] Authentication
  • [x] Sign up (WebView)
  • [x] Sign in
  • [x] Sign out
• [x] Forum
  • [x] View forums
  • [x] View sub forums
  • [x] View topics in each forum
• [ ] Topic
  • [x] View latest topics
  • [x] View hot topics
  • [x] View topic detail and comments
  • [x] View specific comments (only from author, descending order, etc)
  • [x] Publish topic
  • [x] Edit published topic (WebView)
  • [x] Reply topic
  • [x] Reply comment
  • [x] Favor topic
  • [x] Upload images
  • [x] Emoji
  • [x] Show friend list to mention (@)
  • [ ] Report objectionable content
• [ ] Vote
  • [ ] Create vote
  • [x] Join in vote
  • [x] View vote results
• [x] Search
• [x] Notifications
  • [x] View list mentioned (@) me
  • [x] View list replied me
  • [x] View private messages
  • [x] View system notifications
  • [x] Notification alert
• [ ] Individual
  • [x] View my recent topics
  • [x] View my favorite topics
  • [x] Upload avatar
  • [ ] Update password

Try it out

Run in simulator

git clone [email protected]:just4fun/stuhome.git
cd stuhome
yarn

Then use Xcode to open this project and simply click Run.

Run on your iOS device

http://facebook.github.io/react-native/docs/running-on-device.html#running-your-app-on-ios-devices

Todo list

• ~~Update UI per new design~~
• ~~Submit to App Store~~
• ~~Replace deprecated Navigator with React Navigation:~~ #19
• Unit Testing Infrastructure: ~~#8~~, #40

Known issues

• ~~User avatar is not displayed sometimes:~~ RN/#5616 (Fixed by RN/#7262, and the patch is released in 0.26.0)
• ~~Switching between pages is not very smooth sometimes~~ (Fixed by #19)
• Image could not be inserted to TextInput: RN/#17468, RN/#18566
• Unit tests are not working due to deprecated property in react-native-mock. react-native-mock/#158, #40
• You need to patch this fix RN/#25146 in your local if you want to run the app with XCode 11, until the app upgraded to latest RN

FAQ

https://github.com/just4fun/stuhome/wiki/FAQ

License

The MIT License