React Native Meteor Boilerplate
This is a simple way to get started building an app with React Native and Meteor. It is opinionated to make it easy for people to start but if you have your own way of doing things it's very easy to swap things out and move them around however you see fit.
As it currently stands this project is only focused on configuring the React Native project. The Meteor side is up to you. For thoughts on how to structure your Meteor App I would suggest you read the Meteor Guide and the Mantra spec.
You can checkout a very quick walkthrough of the project here.
Getting Started
- Install Meteor
- Install React Native
- Clone Repo:
git clone https://github.com/spencercarli/react-native-meteor-boilerplate.git - From the
MeteorAppdirectory runmeteor npm install - From the
RNAppdirectory runnpm install
Running on iOS Simulator
Note: You must be on a Mac for this.
- Be sure your Meteor app is running: In the
MeteorAppdirectory, typemeteor
You've got a few ways you can run the app for iOS:
- From the
RNAppdirectory runreact-native run-ios
Running on iOS Device
Note: You must be on a Mac for this.
- Be sure your Meteor app is running: In the
MeteorAppdirectory, typemeteor - Get the IP address of your machine (you can run
ipconfig getifaddr en1to do so) - In
RNApp/app/config/settings.jschangelocalhostto your machine's IP address - Plug your device into your computer (make sure it's on the same network)
- Open the project in Xcode
- Select your device in Xcode and press "Build and run"
For further information please reference the official docs.
Running on Android Simulator
- Be sure your Meteor app is running: In the
MeteorAppdirectory, typemeteor - Get the IP address of your machine
- In
RNApp/app/config/settings.jschangelocalhostto your machine's IP address - Make sure you have an emulator configured and running.
- From the
RNAppdirectory runreact-native run-android
On OSX you can get your IP address by running ipconfig getifaddr en1 in a terminal window.
On linux running ifconfig will get you a list of your network interfaces along with their IP addresses. For the stock Google simulator you will want to use the IP of your active network connection (probably eth0 or wlan0). If you are using the Genymotion simulator, it runs in a Virtual Box VM with a Host-only network interface. You will want to use the IP address of this network which may look like vboxnet0 under ifconfig.
Running on Android Device
- Be sure your Meteor app is running: In the
MeteorAppdirectory, typemeteor - Make sure USB Debugging is enabled
- Plug your device into your computer
- Run
adb devicesto make sure your device shows up - Run
adb reverse tcp:8081 tcp:8081 - In
RNApp/app/config/settings.jschangelocalhostinMETEOR_URLto your computer's IP address (see note in "Running on Android" section on how to get your IP Address) - Run
react-native run-android
For further information please reference the official docs.
Linux Setup for Android Dev
Configure how the device will connect to the meteor server. See running android on a device to pick from the options.
Plug in your device and use lusb to find the first 4 digits of your device ID.
lsusb
Bus 001 Device 003: ID 04e8:2e76 Motorola PCS
Enter this in udev rules. In the example we are copying over 04e8
echo SUBSYSTEM=="usb", ATTR{idVendor}=="04e8", MODE="0666", GROUP="plugdev", sudo tee /etc/udev/rules.d/51-android-usb.rules
Check that your device is properly connecting to ADB, the Android Debug Bridge, by using:
adb devices
Note: You should have only one active ADB connection. If you have a simulator running you should close it before proceeding.
These steps are abstracted from the pages running on device selecting the Linux Tab.
Questions?
If you have any questions please open an issue. Thanks!