# avinashcreates/focusgram architecture

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

- Interactive diagram: https://gitdiagram.com/avinashcreates/focusgram
- Repository: https://github.com/avinashcreates/focusgram

## Overview

FocusGram is an Android WebView client that keeps Instagram web features available while locally hiding Explore/Reels entry points and preventing scrolling in individual Reel contexts. The user opens the app, loads Instagram, navigates within the allowed domain, and receives URL-context-specific injection after page loads. MainActivity owns WebView configuration and navigation; FocusInjector applies CSS and DOM guards. README documents useful retained areas (DMs, notifications, profiles, followed feed, shared Reels), but their implementations are Instagram pages rather than separate repository modules. Edges reflect excerpted calls and README claims; no additional unsampled implementation is inferred.

Main entry points: [`app/src/main/java/com/focusgram/app/MainActivity.kt`](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt) (MainActivity), [`app/src/main/java/com/focusgram/app/FocusInjector.kt`](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt) (FocusInjector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Android Client"]
  node_activity["MainActivity<br/>[MainActivity.kt]"]
  node_webview["Instagram WebView<br/>[MainActivity.kt]"]
  node_urlcontext["URL context detection<br/>[MainActivity.kt]"]
  node_navigation["Navigation guard<br/>[MainActivity.kt]"]
  node_lifecycle["Back and lifecycle<br/>[MainActivity.kt]"]
end

subgraph group_filter["Focus Filtering"]
  node_injector["FocusInjector<br/>[FocusInjector.kt]"]
  node_navfilter["Explore/Reels hiding<br/>[FocusInjector.kt]"]
  node_observer["DOM mutation observer<br/>[FocusInjector.kt]"]
  node_reelguard["Reel scroll guard<br/>[FocusInjector.kt]"]
end

subgraph group_instagram["Instagram Web"]
  node_instagram["Instagram web"]
  node_dm["Direct Messages"]
  node_notifications["Notifications"]
  node_profiles["Profile pages"]
  node_feed["Followed-content feed"]
  node_sharedreel["Shared Reel pages"]
end

node_user(("App user"))

node_user -->|"opens app"| node_activity
node_activity -->|"creates and loads"| node_webview
node_webview -->|"loads HTTPS"| node_instagram
node_activity -->|"configures allow-list"| node_navigation
node_activity -->|"updates context"| node_urlcontext
node_activity -->|"installs after page load"| node_injector
node_activity -->|"handles navigation and cleanup"| node_lifecycle
node_injector -->|"injects CSS"| node_navfilter
node_injector -->|"registers observer"| node_observer
node_injector -->|"installs by context"| node_reelguard
node_urlcontext -->|"supplies Reel mode"| node_injector
node_navfilter -->|"hides navigation links"| node_instagram
node_reelguard -->|"blocks vertical scroll"| node_sharedreel
node_user -->|"uses"| node_dm
node_user -->|"uses"| node_notifications
node_user -->|"uses"| node_profiles
node_user -->|"uses"| node_feed
node_user -->|"opens shared page"| node_sharedreel

click node_activity "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt"
click node_webview "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt"
click node_urlcontext "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt"
click node_navigation "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt"
click node_lifecycle "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt"
click node_injector "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt"
click node_navfilter "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt"
click node_observer "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt"
click node_reelguard "https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt"

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_activity,node_webview,node_urlcontext,node_navigation,node_lifecycle,node_user toneBlue
class node_injector,node_navfilter,node_observer,node_reelguard toneAmber
class node_instagram,node_dm,node_notifications,node_profiles,node_feed,node_sharedreel toneMint
```

## Components

### Android Client

- [MainActivity](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt): `app/src/main/java/com/focusgram/app/MainActivity.kt`
- [Instagram WebView](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt): `app/src/main/java/com/focusgram/app/MainActivity.kt`
- [URL context detection](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt): `app/src/main/java/com/focusgram/app/MainActivity.kt`
- [Navigation guard](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt): `app/src/main/java/com/focusgram/app/MainActivity.kt`
- [Back and lifecycle](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/MainActivity.kt): `app/src/main/java/com/focusgram/app/MainActivity.kt`

### Focus Filtering

- [FocusInjector](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt): `app/src/main/java/com/focusgram/app/FocusInjector.kt`
- [Explore/Reels hiding](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt): `app/src/main/java/com/focusgram/app/FocusInjector.kt`
- [DOM mutation observer](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt): `app/src/main/java/com/focusgram/app/FocusInjector.kt`
- [Reel scroll guard](https://github.com/avinashcreates/focusgram/blob/main/app/src/main/java/com/focusgram/app/FocusInjector.kt): `app/src/main/java/com/focusgram/app/FocusInjector.kt`

### Instagram Web

- **Instagram web**
- **Direct Messages**
- **Notifications**
- **Profile pages**
- **Followed-content feed**
- **Shared Reel pages**

### Other components

- **App user**

## Connections

- App user → MainActivity: opens app (evidence: `README.md`)
- MainActivity → Instagram WebView: creates and loads (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- Instagram WebView → Instagram web: loads HTTPS (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- MainActivity → Navigation guard: configures allow-list (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- MainActivity → URL context detection: updates context (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- MainActivity → FocusInjector: installs after page load (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- MainActivity → Back and lifecycle: handles navigation and cleanup (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- FocusInjector → Explore/Reels hiding: injects CSS (evidence: `app/src/main/java/com/focusgram/app/FocusInjector.kt`)
- FocusInjector → DOM mutation observer: registers observer (evidence: `app/src/main/java/com/focusgram/app/FocusInjector.kt`)
- FocusInjector → Reel scroll guard: installs by context (evidence: `app/src/main/java/com/focusgram/app/FocusInjector.kt`)
- URL context detection → FocusInjector: supplies Reel mode (evidence: `app/src/main/java/com/focusgram/app/MainActivity.kt`)
- Explore/Reels hiding → Instagram web: hides navigation links (evidence: `app/src/main/java/com/focusgram/app/FocusInjector.kt`)
- Reel scroll guard → Shared Reel pages: blocks vertical scroll (evidence: `README.md`)
- App user → Direct Messages: uses (evidence: `README.md`)
- App user → Notifications: uses (evidence: `README.md`)
- App user → Profile pages: uses (evidence: `README.md`)
- App user → Followed-content feed: uses (evidence: `README.md`)
- App user → Shared Reel pages: opens shared page (evidence: `README.md`)
