An example project for creating Particle device setup and control applications with React Native.
This app is built for people building products, rather than just claiming individual devices to their developer account.
This means you'll need to insert a few of your own API endpoints for things like allowing a user to log in to the app. For our company, we handle all user registration through invites sent via our web app. The mobile app is purely for people who already have an accout. We'll operate in the same manner here.
There is currently support for the Photon / P1 / P0 family of devices. There are additional steps that will be required for Electrons or Mesh products. If you'd like to contribute to this end, please submit a PR.
Before you start, there are a few things you'll need from your own API:
- An endpoint to handle logging in You'll need a way to confirm someone is a legitimate user when they log in to the mobile app. Part of the response should be their particle access token. If you don't have this, or want to get your access tokens a different way, feel free to refactor.
Download or clone this repo, enter the directory and run:
npm install
to get all the packages you need.
This app was built using Expo and detached with ExpoKit to make use of some native libraries. To use ExpoKit during development, make sure you install exp using:
npm install -g exp
You'll also need to create an account with expo. Immediately after installing exp, you'll want to then use those new login credentials and call
exp login
To start and test your app, run:
exp start
Next, make sure you have your ios and android directories fully set up by following these instructions:
Note: this repo already includes the basic Pods you'll need installed in the iOS folder.
After taking care of those items, you should be able to build and run the app in your simulator of choice!
Every time you want to develop, ensure your project's JS is being served by exp, then run the native code from Xcode or Android Studio respectively.
Your ExpoKit project is configured to load your app's published url when you build it for release. So when you want to release it, don't forget to publish, like with any normal (non-ExpoKit) project.
You'll need to provide your own configurations for things like API urls or Particle Product parameters in a separate config file.
After downloading or cloning this repo, create a new file called config.js in the root directory (where App.js lives) and then copy and paste the following:
const apiBaseUrl = YOUR_URL;
const AppConfig = {
productId: YOUR_PRODUCT_ID_NUMBER,
clientId: YOUR_OAUTH_CLIENTID,
clientSecret: YOUR_OAUTH_CLIENTSECRET,
productSlug: YOUR_PRODUCT_SLUG,
testAccessToken: YOUR_TEST_TOKEN,
loginUrl: `${apiBaseUrl}YOUR_LOGIN_URL`,
};
export default AppConfig;
You can also customize styles in the provided styleconfig.js file