Functionland's Mobile Apps Monorepo

This is the monorepo using nx that contains the source for the Blox App, File Sync App, and Design System component library projects.

Blox

File Sync

About the Apps

Functionland's FxBlox hardware is managed and used by the File Sync and Blox apps. Blox and File Sync can be used independently of each other. The Blox app is responsible for managing, controlling and configuring the FxBlox hardware as well as the setup / linking of wallets for to receiving Fula (rewards) tokens. If you have FxBlox hardware, you will need the Blox app. The File Sync app is responsible for utilizing the FxBlox hardware as a decentralized storage solution for your data.

Note: The word "box" is used interchangeably for "blox"

Quick start

In the root run yarn followed by yarn ios and see our STYLEGUIDE when contributing.

Development

Getting started with development

In the project root run yarn install, this will install all the required dependencies across all the projects.

Requirements

Setup your development environment according to react native setup documentation

Additional requirements:

• CMake 3.10.2 (Android only, available through Android Studio)
• nx as a global dependency (optional).

It is easiest to develop in a Unix based environment as there is currently an issue open for Windows in relation to CMake.

To run the iOS apps in development

yarn ios file-manager

yarn ios box

To run the Android apps in development

yarn android file-manager

yarn android box

If you ran into lstat EEPROM permission issue, you can follow the below:

npx react-native run-android

The above build the android version. Then run the below to start the server:

npx react-native start

Running these commands will install the required native dependencies via Gradle or Cocoapods.

These commands are shorthand for: nx start [app] followed by nx run-ios [app].

The default project is box

Project structure

There are 3 core parts to the folder structure:

• Component Library (Completed):
  • 📁 libs/component-library
    • 📄 src/index.ts exports all components from the component library in src/lib
• Blox app (WIP):
  • 📁 apps/box
    • 📁 src: Contains the actual TypeScript + React-Native FB mobile for the Blox app.
    • 📁 ios: Contains the basic skeleton for a React Native iOS app, plus the native
    • 📁 android: Contains the basic skeleton for a React Native Android app, plus the native
• File Sync app (To Do):
  • 📁 apps/file-manger
    • 📁 src: Contains the actual TypeScript + React-Native FB mobile for the File Sync app.
    • 📁 ios: Contains the basic skeleton for a React Native iOS app, plus the native
    • 📁 android: Contains the basic skeleton

The designs for the app can be found under the design files folder design-files

Restyle

A core library to this monorepo is Shopify's restyle library. This ensures a consistent design language when developing the apps and enables easy plug and play theming with light and dark themes (or any other). We have setup base light and dark themes in the component library theme.ts file. The Blox and File sync apps can implement this theme directly or hydrate their own themes from these base themes. See our style guide rules for more info.

Contributing to the Monorepo

You can contribute by beta testing or by submitting code to either apps (File Sync and Blox) or submitting code to the component library. If you plan to make a contribution please do so through our contribution steps. You can also join us on Discord to discuss ideas.

When submitting code, please make every effort to follow existing conventions and style in order to keep the code as readable as possible.

Please always be respectful when contributing.

How To Run locally?

See Getting started

1- Run rm -rf node_modules && rm -rf /tmp/metro-*

2- Run yarn

3- Set ANDROID_HOME and JAVA_HOME envs.

4- Connect an android device or run an emulator.

5- Run adb reverse tcp:8081 tcp:8081

6- Run yarn android box

Submit to Appstore

yarn install

cd apps/box/ios

pod install --repo-update

Push the changes to repo and then go to Appstore Connect and go to XCode Cloud and start a build. Then submit the build for review

Submit to Google Play

yarn install

cd apps/box/android

./gradlew assembleRelease

It gives you the apk which you can submit to Google Play

Submitting a PR

• For every PR there should be an accompanying issue which the PR solves. If there isn't one please create it.

• The PR itself should only contain code which is the solution for the given issue

• If you are a first time contributor check if there is a good first issue for you

Contribution steps

1. Fork this repository to your own repositiry.

2. Clone the forked repositiry to your local machine.

3. Create your feature branch: git checkout -b my-new-feature

4. Make changes to the project.

5. Commit your changes: git commit -m 'Add some feature'

6. Push to the branch: git push origin my-new-feature

7. Submit a pull request :D

License

By contributing your code, you agree to license your contribution under the terms of the MIT License license.

All files are released with the MIT License license.

Misc

Unresolved branches

Rewards Screen branch relating to the rewards screen is unresolved and in a draft PR.

Github Actions

change the versionCode nad number

BUILD_GRADLE_PATH=${{ github.workspace }}/apps/box/android/app/build.gradle
sed -i "s/versionName \".*\"/versionName \"$NEW_VERSION_NAME\"/" $BUILD_GRADLE_PATH