Getting Started with the Instagram React Native App
Use this guide to run the Instagram-style React Native app package locally and prepare it for your own Firebase project and brand.
Quick Answer
Install dependencies, replace Firebase config files, enable Auth, Firestore, and Storage, deploy rules and indexes, then verify sign-up, profile editing, image post creation, feed display, comments, likes, search, and release readiness.
What Ships In The App Package
- iOS and Android React Native projects;
- authentication flow;
- photo feed;
- profile screens;
- create post flow;
- comments and likes;
- user search and social graph screens;
- Firebase integration code;
- optional Functions, rules, indexes, or seed files depending on package version.
Folder Structure
| Folder | Purpose |
|---|---|
src/screens | Feed, create post, profile, search, comments, and auth screens. |
src/core | Shared UI, social graph, media, auth, and Firebase helpers. |
ios | iOS native project and Firebase iOS config. |
android | Android native project and Firebase Android config. |
firebase | Backend files if included. |
Required Services
| Service | Required for |
|---|---|
| Firebase Authentication | user accounts. |
| Cloud Firestore | posts, comments, reactions, users, relationships. |
| Firebase Storage | image uploads and profile photos. |
| Firebase Functions | notifications, feed fan-out, or media processing if included. |
| Firebase Cloud Messaging | push notifications if included. |
Run Locally
corepack enable
yarn install
yarn start
Then run the native app:
yarn ios
or:
yarn android
Configure Backend
Follow:
- Configure a Firebase Project
- Link Firebase Account to Your Mobile App
- Instagram Firebase Setup
- Firebase Production Checklist
Customize Branding
Update:
- app name;
- app icon;
- splash screen;
- theme colors;
- onboarding assets;
- bundle identifier;
- Android package name;
- Firebase project;
- privacy policy and support URL.
Verification
The app is ready for deeper testing when you can:
- create an account;
- upload a profile photo;
- create an image post;
- see the post in the feed and profile;
- like and comment on a post;
- search for users;
- test notifications if configured.
Troubleshooting
Image post fails
Check Storage rules, file URI handling, Firebase config files, and Functions logs if the upload triggers backend processing.
Feed does not update
Check Firestore indexes, query filters, feed documents, and whether the current user follows the author.
Next Steps
FAQ
Can I use the app without Firebase Storage?
Only for limited UI testing. Image posts and profile photos require Storage.