# kowsickram24/rn_instagram architecture

> Architecture diagram of the GitHub repository kowsickram24/rn_instagram, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kowsickram24/rn_instagram
- Repository: https://github.com/kowsickram24/rn_instagram

## Overview

This repository is a React Native Instagram-style social app. A user enters through authentication or the signed-in navigation stack, then browses and creates posts and stories, manages a profile, and chats. Firebase provides authentication and Firestore-backed data; Redux/RTK Query holds shared application state and story/chat APIs. The file tree and source index establish several product areas, but many screens and navigation modules were not excerpted, so some relationships are intentionally omitted rather than inferred.

Main entry points: [`src/screens/auth/Register.js`](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/auth/Register.js) (Registration), [`App.js`](https://github.com/kowsickram24/rn_instagram/blob/local/App.js) (Application root), [`src/navigation/BottomTab/BottomTab.js`](https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/BottomTab/BottomTab.js) (Main tabs), [`src/navigation/Stack/index.js`](https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/Stack/index.js) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["Application root<br/>[App.js]"]
  node_navigation["Navigation<br/>[index.js]"]
  node_tabs["Main tabs<br/>[BottomTab.js]"]
end

subgraph group_identity["Identity"]
  node_authnav["Auth navigation<br/>[AuthStack.js]"]
  node_login["Login<br/>[login.js]"]
  node_register["Registration<br/>[Register.js]"]
  node_validation["Form validation<br/>[validation.js]"]
  node_firebase["Firebase services<br/>[firebase.config.js]"]
end

subgraph group_social["Social content"]
  node_home["Home feed<br/>[Home.js]"]
  node_feedpost["Feed post<br/>[FeedPost.js]"]
  node_createpost["Create post<br/>[Newpost.js]"]
  node_explore["Explore<br/>[Explore.js]"]
  node_profile["Profile<br/>[Profile.js]"]
  node_story["Stories<br/>[IGstories.js]"]
end

subgraph group_messaging["Messaging and state"]
  node_storyapi["Story API<br/>[storiesApi.js]"]
  node_chat["Chat conversation<br/>[ChatBox.js]"]
  node_chatapi["Chat API<br/>[chatsApi.js]"]
  node_store["Redux store<br/>[index.js]"]
  node_aws["AWS S3 media<br/>[s3bucket.js]"]
end

node_user(("App user"))
node_firestore[("Firestore")]

node_user -.->|"opens"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"provides"| node_store
node_app -->|"checks connection"| node_firebase
node_navigation -.->|"routes"| node_authnav
node_authnav -->|"routes"| node_login
node_authnav -->|"routes"| node_register
node_user -.->|"submits details"| node_register
node_register -->|"validates with"| node_validation
node_register -->|"creates account"| node_firebase
node_register -->|"writes profile"| node_firestore
node_navigation -.->|"routes"| node_tabs
node_tabs -->|"routes"| node_home
node_tabs -->|"routes"| node_explore
node_tabs -->|"routes"| node_profile
node_home -.->|"renders"| node_feedpost
node_user -.->|"creates content"| node_createpost
node_profile -->|"uses"| node_storyapi
node_story -->|"uses"| node_storyapi
node_storyapi -->|"reads and updates"| node_firestore
node_user -.->|"messages"| node_chat
node_chat -->|"reads and writes"| node_firestore
node_chat -.->|"uses media service"| node_aws
node_store -->|"registers middleware"| node_chatapi
node_chatapi -->|"uses"| node_firestore

click node_app "https://github.com/kowsickram24/rn_instagram/blob/local/App.js"
click node_navigation "https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/Stack/index.js"
click node_authnav "https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/Stack/Auth/AuthStack.js"
click node_login "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/auth/login.js"
click node_register "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/auth/Register.js"
click node_validation "https://github.com/kowsickram24/rn_instagram/blob/local/src/utils/validation.js"
click node_firebase "https://github.com/kowsickram24/rn_instagram/blob/local/firebase.config.js"
click node_tabs "https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/BottomTab/BottomTab.js"
click node_home "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/home/Home.js"
click node_feedpost "https://github.com/kowsickram24/rn_instagram/blob/local/src/components/card/FeedPost.js"
click node_createpost "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/post/create/Newpost.js"
click node_explore "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/explore/Explore.js"
click node_profile "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/profile/Profile.js"
click node_story "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/story/IGstories.js"
click node_storyapi "https://github.com/kowsickram24/rn_instagram/blob/local/src/store/slices/storiesApi.js"
click node_chat "https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/chat/ChatBox.js"
click node_chatapi "https://github.com/kowsickram24/rn_instagram/blob/local/src/store/slices/chatsApi.js"
click node_store "https://github.com/kowsickram24/rn_instagram/blob/local/src/store/index.js"
click node_aws "https://github.com/kowsickram24/rn_instagram/blob/local/src/services/aws/s3bucket.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_navigation,node_tabs,node_user toneBlue
class node_authnav,node_login,node_register,node_validation,node_firebase,node_firestore toneAmber
class node_home,node_feedpost,node_createpost,node_explore,node_profile,node_story toneMint
class node_storyapi,node_chat,node_chatapi,node_store,node_aws toneRose
```

## Components

### App shell

- [Application root](https://github.com/kowsickram24/rn_instagram/blob/local/App.js): `App.js`
- [Navigation](https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/Stack/index.js): `src/navigation/Stack/index.js`
- [Main tabs](https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/BottomTab/BottomTab.js): `src/navigation/BottomTab/BottomTab.js`

### Identity

- [Auth navigation](https://github.com/kowsickram24/rn_instagram/blob/local/src/navigation/Stack/Auth/AuthStack.js): `src/navigation/Stack/Auth/AuthStack.js`
- [Login](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/auth/login.js): `src/screens/auth/login.js`
- [Registration](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/auth/Register.js): `src/screens/auth/Register.js`
- [Form validation](https://github.com/kowsickram24/rn_instagram/blob/local/src/utils/validation.js): `src/utils/validation.js`
- [Firebase services](https://github.com/kowsickram24/rn_instagram/blob/local/firebase.config.js): `firebase.config.js`

### Social content

- [Home feed](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/home/Home.js): `src/screens/app/home/Home.js`
- [Feed post](https://github.com/kowsickram24/rn_instagram/blob/local/src/components/card/FeedPost.js): `src/components/card/FeedPost.js`
- [Create post](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/post/create/Newpost.js): `src/screens/app/post/create/Newpost.js`
- [Explore](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/explore/Explore.js): `src/screens/app/explore/Explore.js`
- [Profile](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/profile/Profile.js): `src/screens/app/profile/Profile.js`
- [Stories](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/story/IGstories.js): `src/screens/app/story/IGstories.js`

### Messaging and state

- [Story API](https://github.com/kowsickram24/rn_instagram/blob/local/src/store/slices/storiesApi.js): `src/store/slices/storiesApi.js`
- [Chat conversation](https://github.com/kowsickram24/rn_instagram/blob/local/src/screens/app/chat/ChatBox.js): `src/screens/app/chat/ChatBox.js`
- [Chat API](https://github.com/kowsickram24/rn_instagram/blob/local/src/store/slices/chatsApi.js): `src/store/slices/chatsApi.js`
- [Redux store](https://github.com/kowsickram24/rn_instagram/blob/local/src/store/index.js): `src/store/index.js`
- [AWS S3 media](https://github.com/kowsickram24/rn_instagram/blob/local/src/services/aws/s3bucket.js): `src/services/aws/s3bucket.js`

### Other components

- **App user**
- **Firestore**

## Connections

- App user → Application root: opens
- Application root → Navigation: renders (evidence: `App.js`)
- Application root → Redux store: provides (evidence: `App.js`)
- Application root → Firebase services: checks connection (evidence: `App.js`)
- Navigation → Auth navigation: routes
- Auth navigation → Login: routes (evidence: `src/navigation/Stack/Auth/AuthStack.js`)
- Auth navigation → Registration: routes (evidence: `src/navigation/Stack/Auth/AuthStack.js`)
- App user → Registration: submits details
- Registration → Form validation: validates with (evidence: `src/screens/auth/Register.js`)
- Registration → Firebase services: creates account (evidence: `src/screens/auth/Register.js`)
- Registration → Firestore: writes profile (evidence: `src/screens/auth/Register.js`)
- Navigation → Main tabs: routes
- Main tabs → Home feed: routes (evidence: `src/navigation/BottomTab/BottomTab.js`)
- Main tabs → Explore: routes (evidence: `src/navigation/BottomTab/BottomTab.js`)
- Main tabs → Profile: routes (evidence: `src/navigation/BottomTab/BottomTab.js`)
- Home feed → Feed post: renders
- App user → Create post: creates content
- Profile → Story API: uses (evidence: `src/screens/app/profile/Profile.js`)
- Stories → Story API: uses (evidence: `src/screens/app/story/IGstories.js`)
- Story API → Firestore: reads and updates (evidence: `src/store/slices/storiesApi.js`)
- App user → Chat conversation: messages
- Chat conversation → Firestore: reads and writes (evidence: `src/screens/app/chat/ChatBox.js`)
- Chat conversation → AWS S3 media: uses media service (evidence: `src/screens/app/chat/ChatBox.js`)
- Redux store → Chat API: registers middleware (evidence: `src/store/index.js`)
- Chat API → Firestore: uses (evidence: `src/store/slices/chatsApi.js`)
