alienfractal/fluttergram

A working Instagram clone written in Flutter using Firebase / Firestore

Fluttergram

A working Instagram clone written in Flutter using Firebase / Firestore

Demo

Download the release APK to try out Fluttergram

Features

• Custom photo feed based on who you follow (using firebase cloud functions)
• Post photo posts from camera or gallery
  • Like posts
  • Comment on posts
    • View all comments on a post
• Search for users
• Profile Pages
  • Follow / Unfollow Users
  • Change image view from grid layout to feed layout
  • Add your own bio
• Activity Feed showing recent likes / comments of your posts + new followers

Screenshots

Dependencies

• Flutter
• Firestore
• Image Picker
• Google Sign In
• Firebase Auth
• UUID
• Dart Image
• Path Provider
• Font Awesome
• Dart HTTP
• Dart Async
• Flutter Shared Preferences
• Cached Network Image

Getting started

1. Setup Flutter

2. Clone the repo

$ git clone https://github.com/mdanics/fluttergram.git
$ cd fluttergram/

3. Setup the firebase app

1. You'll need to create a Firebase instance. Follow the instructions at https://console.firebase.google.com.
2. Once your Firebase instance is created, you'll need to enable anonymous authentication.

• Go to the Firebase Console for your new instance.
• Click "Authentication" in the left-hand menu
• Click the "sign-in method" tab
• Click "Google" and enable it

3. Create Cloud Functions (to make the Feed work)

• Create a new firebase project with firebase init
• Copy this project's functions/lib/index.js to your firebase project's functions/index.js
• Push the function getFeed with firebase deploy --only functions In the output, you'll see the getFeed URL, copy that.
• Replace the url in the _getFeed function in feed.dart with your cloud function url from the previous step.

4. Enable the Firebase Database

• Go to the Firebase Console
• Click "Database" in the left-hand menu
• Click the Cloudstore "Create Database" button
• Select "Start in test mode" and "Enable"

5. (skip if not running on Android)

• Create an app within your Firebase instance for Android, with package name com.yourcompany.news
• Run the following command to get your SHA-1 key:

keytool -exportcert -list -v \
-alias androiddebugkey -keystore ~/.android/debug.keystore

• In the Firebase console, in the settings of your Android app, add your SHA-1 key by clicking "Add Fingerprint".
• Follow instructions to download google-services.json
• place google-services.json into /android/app/.

6. (skip if not running on iOS)

• Create an app within your Firebase instance for iOS, with your app package name
• Follow instructions to download GoogleService-Info.plist
• Open XCode, right click the Runner folder, select the "Add Files to 'Runner'" menu, and select the GoogleService-Info.plist file to add it to /ios/Runner in XCode
• Open /ios/Runner/Info.plist in a text editor. Locate the CFBundleURLSchemes key. The second item in the array value of this key is specific to the Firebase instance. Replace it with the value for REVERSED_CLIENT_ID from GoogleService-Info.plist

Double check install instructions for both

• Google Auth Plugin
  • https://pub.dartlang.org/packages/firebase_auth
• Firestore Plugin
  • https://pub.dartlang.org/packages/cloud_firestore

What's Next?

• Improve Caching of Profiles, Images, Etc.
• Notificaitons for likes, comments, follows, etc
• Better post creation, add filters to your image
• Custom Camera Implementation
• Animations (heart when liking image)
• Firebase Security Rules
• Delete Posts
• Registration without Google SignIn
• Direct Messaging
• Stories
• Clean up code