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.

Archievement

Status

This app was published to App Store on Jan 7 2017, now it's retired and archived from Feb 26 2023.

https://apps.apple.com/cn/app/qing-shui-he-pan-stuhome/id1190564355

Some memories about the great experience to build this application during those years - https://www.notion.so/iOS-18468e4a446b49ab8bb8c35d1559d4b5

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 git@github.com: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