Flock is a React Native app designed to help friends coordinate impromptu meetups effortlessly. Built with Expo and Firebase, Flock provides a simple and intuitive interface to make organizing social gatherings easier and more spontaneous.
- Discover Availability: Quickly check who’s free to hang out.
- Chat: In-app chat with your friends with dynamically created group chats.
- Push Notifications: Stay informed when your friends are free or send you a message.
- Cross-Platform: Runs on both iOS and Android.
Follow these instructions to get Flock up and running on your local machine for development and testing purposes.
-
Clone this repository:
git clone https://github.com/samsmithyeah/flock.git cd flock
-
Install dependencies:
npm install
-
Install expo dev client:
npx expo install expo-dev-client
-
Run the application:
npx expo run:ios
or:
npx expo run:android
- Create a Firebase project in the Firebase Console.
- Enable the services required for the app:
- Firestore
- Authentication (Email/password and Google)
- Cloud Functions
- Cloud Messaging (including connection with Apple APNs)
- Download the configuration files and put in project root folder:
google-services.json
(for Android)GoogleService-Info.plist
(for iOS)
- Update the config in firebase.ts for your firebase account
-
Navigate to the
functions
directory:cd functions
-
Install dependencies:
npm install
-
Log in to Firebase CLI:
firebase login
-
Initialize Firebase Functions (if not already done):
firebase init functions
- Select your Firebase project.
- Choose the language for Cloud Functions (JavaScript or TypeScript).
-
Deploy functions:
firebase deploy --only functions
This project is licensed under the MIT License. See the LICENSE file for details.
For any questions or feedback, feel free to reach out to [email protected].