flutter-clean-architecture-instagram
一個功能齊全的 Instagram 克隆應用,使用 Flutter 建構,後端服務由 Firebase 提供支援,並透過 Agora 實現即時視訊通話,提供貼文、故事、聊天、按讚、留言等多項功能。
- 星標
- 334
- 分支
- 97
- 最近推送(UTC)
- 2026年8月25日
- 專案狀態
- 未封存
原始 README
以下為英文專案原文快照,最新內容請造訪 GitHub。
flutter-clean-architecture-instagram
Instagram clean architecture using Flutter and Firebase ( frontend & backend ) with almost all functionalities
🚀 My Next Big Project
If you want to work with me, you can find me here:
Notes
- I didn't publish the keys such as messaging, agora, firebase web, or even google-services.json. So follow the steps (3. Setup the app) to add them.
Features
-
Support
- Arabic & English language
- Dark & Light theme
-
Custom gallery & camera & video display like Instagram "my package" image picker plus
-
Post features
- Support images & videos
- Support multi images in one post or mixin with them
- Like on a post and view all like with their profiles
- Comment on a post and replay on a (comment & replay)
- Like on a comment & replay and view all like with their profiles
- Edit post
- Delete post
- Unfollow the user of the post
-
My Timelines Screen
- Custom posts & stories feed based on followers & followings
- Refresh the posts info
- Loading more posts (it displays five-by-five posts)
-
All Timelines Screen
- View all user's posts (images & videos)
- Change the screen from a grid layout to a timeline layout
-
Search for a user based on username
-
Video Screen
- It displays all user's videos with almost post features
- Control of sound & play
-
Profile Screen
- Follow / Unfollow Users
- Display images & videos in a separate view
- Change the screen from a grid layout to a timeline layout
- Edit profile info
-
Chat Screen
- Chat with any user
- Group chat
- Support
- Text
- Image (gallery & camera)
- Voice
- One-to-one video call
- Group video call
-
Push Notifications
-
Send posts to chats
SnapShots for web
You can see the screen record from here google drive






SnapShots
|--------- Sign page ----------|------- Welcome page --------|-------------- Stories ----------|



|-------- Home screen --------|------ Comment screen ------|-------- Create story ----------|



|--------- Share post --------- |--------- Videos page ---------|---- personal profile page ---|


|---- Change app theme -----|------- Logout & Login --------|-- Change app language -- |



|------ Following users -------|----- Unfollow all users ------|---- Change profile image ----|



|----- All users time line ------|----- Search about user ------|---------- Create post ------- |



|-------- Create video ---------|---- Show created video -----|---- share created video -----|



|----------- Edit post ----------|-------- Notifications ---------|-------- Activity page --------|



|--------------------------- Chatting ----------------------------|


|-------------------------- Video call ---------------------------|


Getting started
1. Setup Flutter
2. Clone the repo
$ git clone https://github.com/AhmedAbdoElhawary/flutter-clean-architecture-instagram
$ cd flutter-clean-architecture-instagram/
3. Setup the app
I made the setup with more details and visuals to make it easy for any level to set up the app.
Click to expand
.Connection with Firebase
- Run this line in your PowerShell as administrator:
Set-ExecutionPolicy RemoteSigned
- Then, press
yto comfirm
- We need to log in with Firebase. Run this line:
firebase login
- Then, press
yto comfirm - Then, choose the account that you want to create Firebase services with it.
- Then, press Allow
- In PowerShell, write the disk that the project is exciting. For example, I have InstaAwesome in D. So, I will write it Like this:
d:
- Add the following line, replacing
<path-to-project-root>with the path to the project root:
cd <path-to-project-root>
- Then, run this line:
dart pub global activate flutterfire_cli
- Then, run this line:
flutterfire configure
Enable Firebase services
Enable those services: Authentication, Firestor Database, Storage, and Messaging. And take the ‘Cloud Messaging server key’ copy from ‘Cloud Messaging’ in ‘Project settings’.
-
Then, past the key in the project
lib\core\utility\private_keys.dartinnotificationKeyafter=like this:
.Connection with Agora
Agora is a real-time communication platform that provides a set of APIs and SDKs for adding voice↳
Step 1: Create an Agora Account and Get a Test Key
Before we can connect our Flutter app with Agora, we need to create an Agora account and get a test key. Here are the steps to get an Agora test key:
-
Go to the Agora website and sign up for an account.
-
After you have signed up, log in to the Agora Project Management with your account credentials.
-
Enter a name for your project and select any Use Case.
-
Select
Testing mode: APP ID
Congratulations! The project is ready.
What's Next?
- [x] Notifications for likes, comments, follows, etc
- [x] Caching of Profiles, Images, Etc.
- [x] Calling video and voice in chat
- [x] Create a group chat
- [x] Calling video and voice in group chat
- [x] Send posts to chats
- [x] control in the dimension of selected images & video from the gallery
- [x] Custom gallery display
- [x] Improve display loading of posts when opening the app
- [x] share post
- [x] Make like, comment, and share of animation container post touchy when long pressed on post
- [x] Make it stable for the web
- [ ] Clean up more code
How to Contribute
- Fork the project
- Create your feature branch (git checkout -b my-new-feature)
- Make required changes and commit (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request
分類
使用的依賴
依賴清單 47 項
- flutter
{"sdk":"flutter"} - bloc
^9.2.0 - flutter_bloc
^9.1.1 - cloud_firestore
^6.1.2 - firebase_auth
^6.1.4 - firebase_core
^4.4.0 - firebase_storage
^13.0.6 - firebase_crashlytics
^5.0.7 - flutter_svg
^2.2.3 - readmore
^3.0.0 - equatable
^2.0.8 - fluttertoast
^9.0.0 - get_it
^9.2.1 - shared_preferences
^2.5.4 - pull_to_refresh
{"git":{"url":"https://github.com/peng8350/flutter_pulltorefresh"}} - carousel_slider
^5.1.2 - inview_notifier_list
^3.0.0 - audioplayers
^6.5.1 - audio_video_progress_bar
^2.0.3 - flutter_phoenix
^1.1.1 - easy_localization
^3.0.8 - animated_text_kit
^4.3.0 - record
^6.2.0 - flutter_image_compress
^2.4.0 - image_picker
^1.2.1 - flutter_staggered_grid_view
^0.7.0 - cached_network_image
^3.4.1 - video_player
^2.11.0 - shimmer
^3.0.0 - get_storage
^2.1.1 - blurhash
^1.2.0 - get
^4.7.3 - video_thumbnail
^0.5.6 - permission_handler
^12.0.1 - overlay_support
^2.1.0 - flutter_blurhash
^0.9.1 - path_provider
^2.1.5 - animated_splash_screen
^1.3.0 - firebase_messaging
^16.1.1 - agora_rtc_engine
^6.5.3 - flutter_local_notifications
^20.1.0 - scrollable_positioned_list
^0.3.8 - flutter_launcher_icons
^0.14.4 - image_picker_plus
^0.5.10+1 - cupertino_icons
^1.0.8 - flutter_test開發依賴
{"sdk":"flutter"} - flutter_lints開發依賴
^6.0.0
所在榜單
如何選擇適合專案的儲存庫?
先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。
- 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
- 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
- 使用前在 GitHub 確認 README、授權條款與 Issues。
來源與維護
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗




























