Hyperlocal is a free, open source, Bluetooth messaging app, built to ensure the privacy and safety of communication between those without internet access.
- Install Node.js
- For ios, install XCode, XCode command line tools, and cocoapods
- Set up React Native to work on your local machine.
- Clone the repository
- Add your Bridgefy API key under
API_KEYinHyperlocal.xcschemeorAndroidManifest.xml. Please contact us if you need help acquiring an API key. - Run
npm installin the root directory - Run
bundle installin the root directory - Run
pod installin theiosdirectory - Run
npm startin the root directory - Run
npx react-native run-iosor in the root directory
- Currently to test the functioning application, you need to build this on a physical phone (not a simulator).
- Ensure that you have the latest version of XCode installed (currently 14.1).
- You will have to have bluetooth enabled on your phone to run the app.
- For the first launch, you will have to have internet connection to verify your keys with the Bridgefy SDK.
- If you see a signing error, you'll have to create an apple developer account, login to XCode with your account, then select "Sign as Personal Account.
- Make sure you have added the Bridgefy SDK API key to the project. See the "Starting the repository" section for more details.
- You will have to use your own Bridgefy SDK API key that is assigned to whatever bundle ID you want to use.
Since this project will be using a mesh network, we will not be using a internet database, but rather a local database. We will be using MMKV, which is a key-value store that is fast and secure. This will be used to store the user's information, as well as the messages that they send and receive.
Hyperlocal utilizes the Bridgefy SDK to power our peer-to-peer messaging protocol. This SDK allows us to create a mesh network between users, and allows us to send messages between users through bluetooth.
Check it out for more information, and be sure to contact the Hyperlocal team if you have any questions.
Bridgefy SDK gives a certain UUID to each user, which we will hash to make more friendly to the user. Along with the User ID, we send nicknames that are associated with the UUID.