bsky-app/README.md

# Social App

In-progress social app.

Uses:

- [React Native](https://reactnative.dev)
- [React Native for Web](https://necolas.github.io/react-native-web/)
- [React Navigation](https://reactnative.dev/docs/navigation#react-navigation)
- [MobX](https://mobx.js.org/README.html) and [MobX State Tree](https://mobx-state-tree.js.org/)
- [Async Storage](https://github.com/react-native-async-storage/async-storage)

## Build instructions

- Setup your environment [using the react native instructions](https://reactnative.dev/docs/environment-setup).
- After initial setup:
  - `cd ios ; pod install`
- Start the dev servers
  - `yarn dev-pds`
  - `yarn dev-wallet`
- Run the dev app
  - iOS: `yarn ios`
  - Android: `yarn android`
  - Web: `yarn web`
- Tips
  - `npx react-native info` Checks what has been installed.
  - On M1 macs, you need to exclude "arm64" from the target architectures
    - Annoyingly this must be re-set via XCode after every pod install

## Various notes

- ["SSO" flows on mobile](https://developer.okta.com/blog/2022/01/13/mobile-sso)
  - Suggests we might want to use `ASWebAuthenticationSession` on iOS
  - [react-native-inappbrowser-reborn](https://www.npmjs.com/package/react-native-inappbrowser-reborn) with `openAuth: true` might be worth exploring
  - We might even [get rejected by the app store](https://community.auth0.com/t/react-native-ios-app-rejected-on-appstore-for-using-react-native-auth0/36793) if we don't
- Cryptography
  - We rely on [isomorphic-webcrypto](https://github.com/kevlened/isomorphic-webcrypto)
  - For the CRNG this uses [react-native-securerandom](https://github.com/robhogan/react-native-securerandom) which provides proper random on mobile
  - For the crypto this uses [msrcrypto](https://github.com/kevlened/msrCrypto) - but we should consider switching to [the MS maintained version](https://github.com/microsoft/MSR-JavaScript-Crypto)
  - In the future it might be preferable to move off of msrcrypto and use iOS and Android native modules, but nothing is available right now
Initial commit 2022-06-08 00:50:05 +02:00			`# Social App`

			`In-progress social app.`

			`Uses:`

			`- [React Native](https://reactnative.dev)`
Add web target 2022-06-08 22:52:12 +02:00			`- [React Native for Web](https://necolas.github.io/react-native-web/)`
Add basic react-navigator usage 2022-06-08 01:56:31 +02:00			`- [React Navigation](https://reactnative.dev/docs/navigation#react-navigation)`
Add state management 2022-06-09 20:03:25 +02:00			`- [MobX](https://mobx.js.org/README.html) and [MobX State Tree](https://mobx-state-tree.js.org/)`
			`- [Async Storage](https://github.com/react-native-async-storage/async-storage)`
Initial commit 2022-06-08 00:50:05 +02:00
			`## Build instructions`

			`- Setup your environment [using the react native instructions](https://reactnative.dev/docs/environment-setup).`
Add basic react-navigator usage 2022-06-08 01:56:31 +02:00			`- After initial setup:`
Add base auth & ucan request flow (web only) 2022-06-14 21:29:47 +02:00			- `cd ios ; pod install`
			`- Start the dev servers`
			- `yarn dev-pds`
			- `yarn dev-wallet`
			`- Run the dev app`
			- iOS: `yarn ios`
			- Android: `yarn android`
			- Web: `yarn web`
Initial commit 2022-06-08 00:50:05 +02:00			`- Tips`
			- `npx react-native info` Checks what has been installed.
Polyfills for native crypto 2022-06-16 00:40:18 +02:00			`- On M1 macs, you need to exclude "arm64" from the target architectures`
			`- Annoyingly this must be re-set via XCode after every pod install`
Add custom protocol deep links 2022-06-14 05:12:43 +02:00
			`## Various notes`

			`- ["SSO" flows on mobile](https://developer.okta.com/blog/2022/01/13/mobile-sso)`
			- Suggests we might want to use `ASWebAuthenticationSession` on iOS
			- [react-native-inappbrowser-reborn](https://www.npmjs.com/package/react-native-inappbrowser-reborn) with `openAuth: true` might be worth exploring
Polyfills for native crypto 2022-06-16 00:40:18 +02:00			`- We might even [get rejected by the app store](https://community.auth0.com/t/react-native-ios-app-rejected-on-appstore-for-using-react-native-auth0/36793) if we don't`
			`- Cryptography`
			`- We rely on [isomorphic-webcrypto](https://github.com/kevlened/isomorphic-webcrypto)`
			`- For the CRNG this uses [react-native-securerandom](https://github.com/robhogan/react-native-securerandom) which provides proper random on mobile`
			`- For the crypto this uses [msrcrypto](https://github.com/kevlened/msrCrypto) - but we should consider switching to [the MS maintained version](https://github.com/microsoft/MSR-JavaScript-Crypto)`
			`- In the future it might be preferable to move off of msrcrypto and use iOS and Android native modules, but nothing is available right now`