An open API service indexing awesome lists of open source software.

https://github.com/morikeli/instagram-mobile-app-clone

An Instagram app clone for Android and iOS developed with Flutter.
https://github.com/morikeli/instagram-mobile-app-clone

android android-application cross-platform cross-platform-app dart dart3 flutter flutter-app instagram-app instagram-clone instagram-mobile instagram-mobile-app ios ios-app mobile-app mobile-application social-media social-media-app

Last synced: 5 months ago
JSON representation

An Instagram app clone for Android and iOS developed with Flutter.

Awesome Lists containing this project

README

          

# Instagram mobile app clone

## Mobile app screenshots

| Splash screen (light) | Splash screen (dark) |
| --------------------- | -------------------- |
| ![Screenshot_20241229-005001](https://github.com/user-attachments/assets/24ddfa35-53a7-488e-a1b6-10f526e3a9e7) | ![Screenshot_20241229-004825](https://github.com/user-attachments/assets/d78b3116-259f-4ac8-8097-55a90f807a41) |
| | |
| | |
| Login screen | Signup screen |
| ![login-screen](https://github.com/user-attachments/assets/e32d329f-026d-4b47-a479-3d924de5689e) | ![signup-screen](https://github.com/user-attachments/assets/7038f7e4-43c6-4a76-b928-fdaa9f66daa5) |
| | |
| | |
| Home screen | Homescreen on scroll |
| ![homescreen](https://github.com/user-attachments/assets/39ed7157-d83a-4670-aefc-5c362523252a) | ![homescreen-on-scroll](https://github.com/user-attachments/assets/c4a40d06-2b24-4717-a395-20e15c1f1af0) |
| | |
| | |
| Instagram stories | Instagram stories on scroll |
| ![homepage-viewed-instagram-stories](https://github.com/user-attachments/assets/8db51c58-ff01-4945-8007-c652d79d8d0c) | ![homescreen-instagram-stories-on-scroll](https://github.com/user-attachments/assets/d7339fac-512b-4885-89ff-a436700b8e49) |
| | |
| | |
| Search screen | Search screen on scroll |
| ![search-screen](https://github.com/user-attachments/assets/41ac95f3-1771-4428-9fff-3162d3e00a68) | ![search-screen-on-scroll](https://github.com/user-attachments/assets/8d9f9917-96bd-4f88-8d1d-04cbe0abbd04) |
| | |
| | |
| Profile screen | Profile screen on scroll |
| ![profile-screen](https://github.com/user-attachments/assets/a2ef5a2b-8aea-4ad4-a7e7-b359a0c00b46) | ![profile-screen-on-scroll](https://github.com/user-attachments/assets/47410d7f-b0bd-46da-9d5b-c216af3b0c96) |
| | |
| | |
| Settings | Settings on scroll |
| ![settings](https://github.com/user-attachments/assets/10c3fc78-2adf-455c-b905-5d0ca1ebbeda) | ![settings-on-scroll](https://github.com/user-attachments/assets/c1d9462b-ccdc-47f9-9b12-5d830f16f067) |
| | |
| | |
| Message screen | Message screen on scroll |
| ![message_screen](https://github.com/user-attachments/assets/01b4a04f-f70a-4b1e-ba44-505a6d3fcb15) | ![message-screen-on-scroll](https://github.com/user-attachments/assets/e5372e3d-871a-4d6e-9ef6-df92c85dc0eb) |
| | |
| | |
| Chat screen | Chat screen on scroll |
| ![chat-screen](https://github.com/user-attachments/assets/57c60b92-b796-4b45-8f8b-098d1de93d47) | ![chat-screen-on-scroll](https://github.com/user-attachments/assets/d23930d8-111f-410f-9e50-68164b6e01f1) |
| | |
| | |
| Details screen | Details screen (toggle on) |
| ![details-screen](https://github.com/user-attachments/assets/ce65b762-7f52-4a0c-85b5-bd09b8cbb77f) | ![details-screen-switch-on](https://github.com/user-attachments/assets/763f26f0-7217-432d-ba95-c43eb3f2d8c5) |
| Reels screen | Reels screen on scroll |
| | |
| | |
| ![Screenshot_20241229-005817](https://github.com/user-attachments/assets/e3036dd8-0e9b-442a-81aa-6e76dcfab17a) | ![Screenshot_20241229-005845](https://github.com/user-attachments/assets/951f9ba0-457f-4f38-b97d-8922ccdc33c7) |

## Overview
This is a Instagram mobile app clone developed for both Android and iOS.

## Developer instructions
---
**NOTE**:
* To run this project, you **MUST** install Flutter SDK on your machine. Refer to [Flutter's documentation](https://docs.flutter.dev/get-started/install) and follow a step-by-step guide on how you can install Flutter SDK on your OS.

* Make sure you have installed Android Studio or a text editor of your choice - VS Code or XCode.

* Make sure your machine supports virtualization - required to run an emulator. If it doesn't, don't worry, you can install `scrcpy` on your machine or use Android Studio's `mirror device` feature.

**Scrcpy Installation guide**
* [Install scrcpy on Windows](https://github.com/Genymobile/scrcpy/blob/master/doc/windows.md)
* [Install scrcpy on Linux](https://github.com/Genymobile/scrcpy/blob/master/doc/linux.md)
* [Install scrcpy on MacOS](https://github.com/Genymobile/scrcpy/blob/master/doc/macos.md)

---

#### Installation guide for developers

1. Git clone
Clone this repository by opening your terminal/CMD and change the current working directory to Desktop - use `cd Desktop` command.
```bash
$ cd Desktop
$ git clone https://github.com/morikeli/instagram-mobile-app-clone.git
```

2. Open the cloned repository on your text editor and run this command:
```bash
$ flutter run
```
3. Make sure you have a very strong internet connection so that the necessary gradle files can be downloaded. These files are necessary to build the project `apk` file.

---
**Keep in mind**:
* When building the application for the first time, it may take 10 - 15 minutes to finish the installation and build process.
* When running the application using the `flutter run` command, it may take atleast a minute to install the build files on a physical device.
---

## Contributor expectations
Incase of a bug or you wish to make a contribution, create a new branch using the git command `git checkout -b ` and create a pull request. Wait for review.

You can also open an issue using the `Issues` tab. The reported issue will be reviewed and a solution may be provided.

## Request
Don't forget to star the repo 🌟😉

## Known issues
The app is still under development. More features will be added with time.