Onboarding
Once you installed BikeRR from TestFlight everything happens automatically. You will be asked for "Always Location permission" and "Motion permission" immediatley after the start. This will change in the future when there's a nice onboarding screen, but for now you need to grant access to these permission to test BikeRR in automatic-mode.
Note: You can configure BikeRR to run in manual mode if that's what you like. You don't need "Motion Permission" then, and you can have BikeRR ask for "When In Use Location Permission", only.
0 step
You're all set. Just go one with your live and BikeRR will happily record your bike trips. If you want to know more keep on reading.
What BikeRR does
BikeRR sets up a geofence or region monitor (a 100m circle) around your current location. When you leave that circle the app wakes up and immediatley starts recording location data. It queries the iPhone for your detected motion activity, too. If that motion is cycling (or what you configured it to be) BikeRR will continue to record a trip, if not BikeRR will stop and set up a new region monitor. You don't have to do anything.
First steps
When you granted "Location Permission" and "Motion Permission" BikeRR will fake a region exit on the first start. If you have the status screen open you'll see the Location Service State: running(region). Depending on wether you're outside (good GPS reception) or inside (not so good) you'll see that BikeRR collects some locations.
The default setting is to only record bike trips so under Auto Stop Service you'll see that BikeRR is about to stop the recording: willStop. This stop will happen after a grace period that you can configure. The default is 35 seconds. So after 35 seconds BikeRR will stop the current recording and discard it because it was to short. If you would have been riding a bike BikeRR would have continued the recording and saved it to it's database once you end your trip.
Fake a region exit
If you want to repeat that "demo" triple-tap on the label "Last Location". BikeRR will now fake a region exit event again. Maybe this time you can have an eye on the Activity. If you have your phone sitting on a desk it might show 🛏 which means stationary. If you shake it rhythmically you might get 🚶♂️-walking, or 🏃♀️-running. This is what stops the recording. It is configured to only keep on recording when it "sees" 🚴-cycling. You can configure the activities that you want to record in the settings. (You guessed it: triple tap on "Autorecorded Activities" – UX I can!)
Region Monitor
When the second trip ended automatically BikeRR created a new region monitor. You should see that under Monitored region and – shortly after – Geocoded. This is a 100m circular region around where you are. If you leave that region BikeRR will start a recording. If you leave it walking the recording will be stopped and discarded (like you saw), if you leave it cycling BikeRR will continue to record and then save the trip, later.
Don't worry if you have to stop to get something out of your backpack while riding your bike. BikeRR might no longer see the cycling activity but it won't stop the trip immediately – this is what the 35 seconds grace period is for. If BikeRR "sees" another cycling-activity it grants you another full grace period.
Quality of Motion Activity Recognition
If you record the automotive activity and have your phone connected to carplay or the like it is super stable. You can sit in a traffic jam all day and the iphone will still "know" with a high confidence that you're driving. Running is a pretty stable state, too. You can adjust the grace period under Settings when you triple tap on the label "Autorecorded Activities".
Manual Mode
If you want to see a trip saved to the database just triple-tap on the label Location Service. This will start BikeRR in manual mode. CAUTON! This will record forever or until you triple-tap Location Service, again. Wait until BikeRR has collected about 50 locations (you need five more then what you have configured as grace period) before you stop it and then you should have a trip in the trip list.
Trip List
If you don't see a picture of your trip on a map, please triple tap any information of the trip summary. That will augment the trip with pictures for light and darkmode.
Thanks a lot for testing. Please share your feedback with me