← Back to the universe 05 / 13

05 / IOS APP · PERSONAL PROJECT

Runs

An iPhone app for making friends over recreational sports and planning pickup games at the park.

FlutterFirebaseiOS

Why I built Runs

A good pickup game can be the start of a friendship. The awkward part is getting to the second game. A group chat can get too big to add everyone you meet, and swapping Instagram handles makes it easy to forget who you played with or when to reach out.

Even with people you already know, organizing a game means asking who’s free, what they want to play, and whether enough people can make it. Sometimes all you know is that you might be up for basketball after work tomorrow. That’s useful information for friends who are also on the fence, and it’s too tentative for a calendar invite.

From meeting someone to playing again

Runs lets you add someone by scanning a QR code at the park, looking them up by phone or contacts, or sharing an invite link. Once you’re friends, they can see the games you post and you can see when they’re up for playing. I also built profiles, profile pictures, content moderation, and terms of service to support those interactions.

Organize a pickup game

Pick a sport, a park, a time, and the minimum number of players. Your friends can see the run, RSVP with In, Maybe, or Out, and sort out details in the comments. The headcount shows how many more players are needed, and the run is marked as on once enough people commit.

Empty schedule with a button to create the first pickup game
Runs home
Form to choose the sport, park, date, time, and minimum number of players
Create a run
Volleyball run with a player count, In, Maybe, and Out responses, and comments
RSVP and headcount

Share when you’re up for playing

You can set an availability status like “volleyball this weekend.” Friends see it until it expires. Runs counts friends with active, matching statuses for the same sport. When enough friends are up for it at the same time, a push notification suggests starting a run. You can use that signal to pick a time that works for the group.

Friends tab with the current availability status and controls for friend requests
Friends list
Options to add a friend by phone number, contacts, QR code, or invite link
Add a friend
Status editor for sharing a sport and how long you are available to play
Set availability

Backend and iOS setup

I built the Flutter app with Firebase Auth for phone verification and Firebase Data Connect backed by PostgreSQL for profiles, friendships, runs, and RSVPs. Cloud Functions handle events such as RSVPs and availability updates and send pushes through Firebase Cloud Messaging. On iOS, I set up Apple signing and provisioning for distribution, APNs credentials and entitlements for push delivery, and App Attest through Firebase App Check.

Runs is in beta and has been submitted to the App Store.