From 8004eec011525f37dad63c2fa2e00662c25010fe Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 11:14:21 +0100
Subject: [PATCH 01/12] Feat : added new filetree

---
 app/build.gradle.kts                          |   1 +
 app/src/main/AndroidManifest.xml              |   4 +
 .../fragments/BaseFragment.java               |   6 +-
 .../fragments/MainFragment.java               | 123 ++++++++++-
 app/src/main/res/drawable/git_24px.xml        |  14 ++
 .../ic_folder_rounded_filled_24dp.xml         |  10 +
 .../ic_menu_open_rounded_filled_24dp.xml      |  11 +
 app/src/main/res/layout/fragment_main.xml     | 115 +++++++++-
 app/src/main/res/menu/sheet_options_menu.xml  |  14 ++
 build.gradle.kts                              |   1 +
 filetree/.gitignore                           |   1 +
 filetree/build.gradle                         |  43 ++++
 filetree/proguard-rules.pro                   |  21 ++
 filetree/src/main/AndroidManifest.xml         |   1 +
 .../kotlin/com/zyron/filetree/FileTree.kt     | 199 +++++++++++++++++
 .../zyron/filetree/adapter/FileTreeAdapter.kt | 206 ++++++++++++++++++
 .../filetree/callback/FileTreeDiffCallback.kt |  43 ++++
 .../zyron/filetree/datamodel/FileTreeNode.kt  |  61 ++++++
 .../filetree/events/FileTreeEventListener.kt  |  58 +++++
 .../zyron/filetree/map/ConcurrentFileMap.kt   | 119 ++++++++++
 .../com/zyron/filetree/map/FileMapManager.kt  |  59 +++++
 .../provider/DefaultFileIconProvider.kt       | 100 +++++++++
 .../filetree/provider/FileIconProvider.kt     |  69 ++++++
 .../kotlin/com/zyron/filetree/utils/Utils.kt  |  31 +++
 .../filetree/viewholder/FileTreeViewHolder.kt |  41 ++++
 .../com/zyron/filetree/widget/FileTreeView.kt | 165 ++++++++++++++
 filetree/src/main/res/anim/default_anim.xml   |   5 +
 .../src/main/res/anim/default_animation.xml   |   5 +
 filetree/src/main/res/anim/fall_down.xml      |  16 ++
 .../src/main/res/anim/fall_down_animation.xml |   5 +
 filetree/src/main/res/anim/rotate_in.xml      |  14 ++
 .../src/main/res/anim/rotate_in_animation.xml |   5 +
 filetree/src/main/res/anim/scale_up.xml       |  16 ++
 .../src/main/res/anim/scale_up_animation.xml  |   5 +
 filetree/src/main/res/anim/slide_in.xml       |  12 +
 .../src/main/res/anim/slide_in_animation.xml  |   5 +
 filetree/src/main/res/drawable/ic_chevron.xml |  11 +
 filetree/src/main/res/drawable/ic_file.xml    |  11 +
 filetree/src/main/res/drawable/ic_folder.xml  |  10 +
 .../drawable/item_activated_background.xml    |  24 ++
 .../res/drawable/item_selected_background.xml |  24 ++
 .../res/drawable/item_view_background.xml     |  30 +++
 .../main/res/layout/filetree_view_item.xml    |  51 +++++
 filetree/src/main/res/values/attrs.xml        |  33 +++
 gradle/libs.versions.toml                     |   3 +
 settings.gradle.kts                           |   1 +
 46 files changed, 1796 insertions(+), 6 deletions(-)
 create mode 100755 app/src/main/res/drawable/git_24px.xml
 create mode 100644 app/src/main/res/drawable/ic_folder_rounded_filled_24dp.xml
 create mode 100644 app/src/main/res/drawable/ic_menu_open_rounded_filled_24dp.xml
 create mode 100644 app/src/main/res/menu/sheet_options_menu.xml
 create mode 100755 filetree/.gitignore
 create mode 100755 filetree/build.gradle
 create mode 100755 filetree/proguard-rules.pro
 create mode 100755 filetree/src/main/AndroidManifest.xml
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt
 create mode 100755 filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt
 create mode 100755 filetree/src/main/res/anim/default_anim.xml
 create mode 100755 filetree/src/main/res/anim/default_animation.xml
 create mode 100755 filetree/src/main/res/anim/fall_down.xml
 create mode 100755 filetree/src/main/res/anim/fall_down_animation.xml
 create mode 100755 filetree/src/main/res/anim/rotate_in.xml
 create mode 100755 filetree/src/main/res/anim/rotate_in_animation.xml
 create mode 100755 filetree/src/main/res/anim/scale_up.xml
 create mode 100755 filetree/src/main/res/anim/scale_up_animation.xml
 create mode 100755 filetree/src/main/res/anim/slide_in.xml
 create mode 100755 filetree/src/main/res/anim/slide_in_animation.xml
 create mode 100755 filetree/src/main/res/drawable/ic_chevron.xml
 create mode 100755 filetree/src/main/res/drawable/ic_file.xml
 create mode 100755 filetree/src/main/res/drawable/ic_folder.xml
 create mode 100755 filetree/src/main/res/drawable/item_activated_background.xml
 create mode 100755 filetree/src/main/res/drawable/item_selected_background.xml
 create mode 100755 filetree/src/main/res/drawable/item_view_background.xml
 create mode 100755 filetree/src/main/res/layout/filetree_view_item.xml
 create mode 100755 filetree/src/main/res/values/attrs.xml

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index b1b2363..497df57 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -66,6 +66,7 @@ dependencies {
     implementation(libs.transition)
     implementation(libs.fragment)
     implementation(libs.activity)
+    implementation(project(":filetree"))
 
 
 
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index 9cc8bfe..002c7f0 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -2,6 +2,10 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools">
 
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
     <application
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
diff --git a/app/src/main/java/com/sparkleseditor/fragments/BaseFragment.java b/app/src/main/java/com/sparkleseditor/fragments/BaseFragment.java
index 0a17f75..cc4da2d 100644
--- a/app/src/main/java/com/sparkleseditor/fragments/BaseFragment.java
+++ b/app/src/main/java/com/sparkleseditor/fragments/BaseFragment.java
@@ -6,10 +6,12 @@
 
 import com.google.android.material.transition.MaterialSharedAxis;
 
+import java.io.File;
+
 
 /* Special Thanks to @yamenher for providing the class */
 
-public class BaseFragment extends Fragment {
+public abstract class BaseFragment extends Fragment {
     @Override
     public void onCreate(Bundle b) {
         super.onCreate(null);
@@ -18,4 +20,6 @@ public void onCreate(Bundle b) {
         setExitTransition(new MaterialSharedAxis(MaterialSharedAxis.X, true));
         setReenterTransition(new MaterialSharedAxis(MaterialSharedAxis.X, false));
     }
+
+
 }
diff --git a/app/src/main/java/com/sparkleseditor/fragments/MainFragment.java b/app/src/main/java/com/sparkleseditor/fragments/MainFragment.java
index dfe2faa..58922fc 100644
--- a/app/src/main/java/com/sparkleseditor/fragments/MainFragment.java
+++ b/app/src/main/java/com/sparkleseditor/fragments/MainFragment.java
@@ -1,29 +1,84 @@
 package com.sparkleseditor.fragments;
 
 import android.annotation.SuppressLint;
+import android.content.Intent;
 import android.graphics.Color;
+import android.net.Uri;
 import android.os.Bundle;
+import android.os.Environment;
+import android.provider.DocumentsContract;
+import android.util.Log;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
+import android.widget.Toast;
 
+import com.zyron.filetree.events.FileTreeEventListener;
+
+import androidx.activity.result.ActivityResultCallback;
+import androidx.activity.result.ActivityResultLauncher;
+import androidx.activity.result.contract.ActivityResultContracts;
 import androidx.annotation.NonNull;
-import androidx.appcompat.app.ActionBarDrawerToggle;
 import androidx.core.view.GravityCompat;
-import androidx.core.view.ViewCompat;
 import androidx.drawerlayout.widget.DrawerLayout;
 import androidx.fragment.app.Fragment;
+import androidx.transition.TransitionManager;
 
+import com.google.android.material.snackbar.Snackbar;
+import com.google.android.material.transition.MaterialSharedAxis;
 import com.sparkleseditor.R;
 import com.sparkleseditor.components.ExpandableLayout;
 import com.sparkleseditor.databinding.FragmentMainBinding;
 import com.sparkleseditor.navigation.Navigator;
+import com.zyron.filetree.events.FileTreeEventListener;
+import com.zyron.filetree.provider.FileTreeIconProvider;
+
+import java.io.File;
 
 import io.github.rosemoe.sora.widget.SymbolInputView;
 
-public class MainFragment extends BaseFragment {
+public class MainFragment extends BaseFragment implements FileTreeEventListener {
+
+
+    private final ActivityResultLauncher<Uri> folderPickerLauncher =
+            registerForActivityResult(
+                    new ActivityResultContracts.OpenDocumentTree(),
+                    treeUri -> {
+                        if (treeUri == null) return;
+
+                        int flags = Intent.FLAG_GRANT_READ_URI_PERMISSION |
+                                Intent.FLAG_GRANT_WRITE_URI_PERMISSION;
+
+                        requireContext().getContentResolver()
+                                .takePersistableUriPermission(treeUri, flags);
+
+                        path = getRealPathFromUri(treeUri);
+                        setupFileTree();
+                        Toast.makeText(requireContext(), "Folder selected!", Toast.LENGTH_LONG).show();
+
+                    }
+            );
+    private String getRealPathFromUri(Uri treeUri) {
+        String docId = DocumentsContract.getTreeDocumentId(treeUri);
+        String[] split = docId.split(":");
+        String type = split[0];
+        String relativePath = split.length > 1 ? split[1] : "";
+        if ("primary".equalsIgnoreCase(type)) {
+            return Environment.getExternalStorageDirectory() + "/" + relativePath;
+        } else {
+            String externalStorage = System.getenv("SECONDARY_STORAGE");
+            if (externalStorage == null) {
+                externalStorage = System.getenv("EXTERNAL_STORAGE");
+            }
+            return externalStorage + "/" + relativePath;
+        }
+    }
 
     private FragmentMainBinding binding;
+    private FileTreeIconProvider fileIconProvider;
+    private String path ="";
+
+    private static final int REQUEST_CODE_OPEN_DIRECTORY = 1001;
 
     public static final String[] SYMBOLS = {
             "TAB","↵", "{", "}", "(", ")",
@@ -39,6 +94,11 @@ public class MainFragment extends BaseFragment {
             ">", "[", "]", ":"
     };
 
+    public interface FileTreeEventListener {
+        void onFileClick(File file);
+        void onFolderClick(File folder);
+    }
+
     @Override
     public View onCreateView(
             @NonNull LayoutInflater inflater, ViewGroup container,
@@ -52,14 +112,50 @@ public View onCreateView(
 
     public void onViewCreated(@NonNull View view, Bundle savedInstanceState) {
         super.onViewCreated(view, savedInstanceState);
+
+        //AppStruct
         setupToolbar();
         setupToolbox();
         setupInputView();
         setupTabLayoutTemp();
         slideXDrawer();
+        drawerLeftContent();
         binding.fab.setTranslationY(-12);
+    }
 
+    private void drawerLeftContent() {
+
+        binding.fileTree.setVisibility(View.VISIBLE);
+        binding.contentGit.setVisibility(View.GONE);
+        binding.btmOptions.setOnNavigationItemSelectedListener(
+                item -> {
+                    var sharedAxis = new MaterialSharedAxis(MaterialSharedAxis.X, true);
+                    TransitionManager.beginDelayedTransition(binding.container, sharedAxis);
+                    if (item.getItemId() == R.id.option_file_tree) {
+                        binding.contentGit.setVisibility(View.GONE);
+                        binding.fileTree.setVisibility(View.VISIBLE);
+                    } else if (item.getItemId() == R.id.option_git) {
+                        binding.contentGit.setVisibility(View.VISIBLE);
+                        binding.fileTree.setVisibility(View.GONE);
+                    }
+                    return true;
+                }
+        );
+        setupFileTree();
+    }
 
+    private void setupFileTree() {
+        if (path != null && !path.isEmpty()) {
+            binding.contentFileTree.setVisibility(View.VISIBLE);
+            binding.requireFolder.setVisibility(View.GONE);
+            binding.fileTreeView.initializeFileTree(path, this , fileIconProvider);
+        }else{
+            binding.contentFileTree.setVisibility(View.GONE);
+            binding.requireFolder.setVisibility(View.VISIBLE);
+            binding.openFolder.setOnClickListener(v -> {
+                folderPickerLauncher.launch(null);
+            });
+        }
     }
 
     private void slideXDrawer() {
@@ -189,6 +285,27 @@ public void onDestroyView() {
         binding = null;
     }
 
+    public void onFileClick(File file) {
+    }
+
+
+    public void onFolderClick(File folder) {}
+
+
+    public boolean onFileLongClick(File file) {
+        return true;
+    }
+
+
+    public boolean onFolderLongClick(File folder) {
+
+        return true;
+    }
+
+
+    public void onFileTreeViewUpdated(int startPosition, int itemCount) {}
+
+
 
 
 
diff --git a/app/src/main/res/drawable/git_24px.xml b/app/src/main/res/drawable/git_24px.xml
new file mode 100755
index 0000000..c7f0c5a
--- /dev/null
+++ b/app/src/main/res/drawable/git_24px.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:width="24dp"
+	android:height="24dp"
+	android:viewportHeight="24"
+	android:viewportWidth="24"
+	android:tint="?colorOnSurface">
+
+		<path
+			android:fillColor="#ff000000"
+			android:pathData="M2.6,10.59L8.38,4.8L10.07,6.5C9.83,7.35 10.22,8.28 11,8.73V14.27C10.4,14.61 10,15.26 10,16A2,2 0,0 0,12 18A2,2 0,0 0,14 16C14,15.26 13.6,14.61 13,14.27V9.41L15.07,11.5C15,11.65 15,11.82 15,12A2,2 0,0 0,17 14A2,2 0,0 0,19 12A2,2 0,0 0,17 10C16.82,10 16.65,10 16.5,10.07L13.93,7.5C14.19,6.57 13.71,5.55 12.78,5.16C12.35,5 11.9,4.96 11.5,5.07L9.8,3.38L10.59,2.6C11.37,1.81 12.63,1.81 13.41,2.6L21.4,10.59C22.19,11.37 22.19,12.63 21.4,13.41L13.41,21.4C12.63,22.19 11.37,22.19 10.59,21.4L2.6,13.41C1.81,12.63 1.81,11.37 2.6,10.59Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/app/src/main/res/drawable/ic_folder_rounded_filled_24dp.xml b/app/src/main/res/drawable/ic_folder_rounded_filled_24dp.xml
new file mode 100644
index 0000000..5923958
--- /dev/null
+++ b/app/src/main/res/drawable/ic_folder_rounded_filled_24dp.xml
@@ -0,0 +1,10 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="960"
+    android:viewportHeight="960"
+    android:tint="?attr/colorOnSurface">
+  <path
+      android:fillColor="@android:color/white"
+      android:pathData="M160,800Q127,800 103.5,776.5Q80,753 80,720L80,240Q80,207 103.5,183.5Q127,160 160,160L367,160Q383,160 397.5,166Q412,172 423,183L480,240L800,240Q833,240 856.5,263.5Q880,287 880,320L880,720Q880,753 856.5,776.5Q833,800 800,800L160,800Z"/>
+</vector>
diff --git a/app/src/main/res/drawable/ic_menu_open_rounded_filled_24dp.xml b/app/src/main/res/drawable/ic_menu_open_rounded_filled_24dp.xml
new file mode 100644
index 0000000..b861603
--- /dev/null
+++ b/app/src/main/res/drawable/ic_menu_open_rounded_filled_24dp.xml
@@ -0,0 +1,11 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="960"
+    android:viewportHeight="960"
+    android:tint="?attr/colorOnSurface"
+    android:autoMirrored="true">
+  <path
+      android:fillColor="@android:color/white"
+      android:pathData="M160,720Q143,720 131.5,708.5Q120,697 120,680Q120,663 131.5,651.5Q143,640 160,640L600,640Q617,640 628.5,651.5Q640,663 640,680Q640,697 628.5,708.5Q617,720 600,720L160,720ZM756,652L612,508Q600,496 600,480Q600,464 612,452L756,308Q767,297 784,297Q801,297 812,308Q823,319 823,336Q823,353 812,364L696,480L812,596Q823,607 823,624Q823,641 812,652Q801,663 784,663Q767,663 756,652ZM160,520Q143,520 131.5,508.5Q120,497 120,480Q120,463 131.5,451.5Q143,440 160,440L480,440Q497,440 508.5,451.5Q520,463 520,480Q520,497 508.5,508.5Q497,520 480,520L160,520ZM160,320Q143,320 131.5,308.5Q120,297 120,280Q120,263 131.5,251.5Q143,240 160,240L600,240Q617,240 628.5,251.5Q640,263 640,280Q640,297 628.5,308.5Q617,320 600,320L160,320Z"/>
+</vector>
diff --git a/app/src/main/res/layout/fragment_main.xml b/app/src/main/res/layout/fragment_main.xml
index aa44cb8..2b1af4d 100644
--- a/app/src/main/res/layout/fragment_main.xml
+++ b/app/src/main/res/layout/fragment_main.xml
@@ -133,14 +133,125 @@
             app:srcCompat="@drawable/ic_play_arrow_rounded_filled_24dp" />
 
 
-
     </androidx.coordinatorlayout.widget.CoordinatorLayout>
 
     <com.google.android.material.navigation.NavigationView
         android:layout_width="wrap_content"
         android:layout_height="match_parent"
         android:layout_gravity="start"
-        android:id="@+id/left_drawer_menu"/>
+        android:id="@+id/left_drawer_menu">
+
+        <LinearLayout
+            android:id="@+id/content_drawer"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginBottom="4dp"
+            android:clickable="true"
+            android:orientation="vertical"
+            android:fitsSystemWindows="true">
+            <!-- the old sidesheet layout goes here -->
+            <LinearLayout
+                android:layout_height="wrap_content"
+                android:layout_width="match_parent"
+                android:gravity="end"
+                android:orientation="horizontal">
+                <TextView
+                    android:layout_height="match_parent"
+                    android:layout_width="match_parent"
+                    android:text="@string/app_name"
+                    android:textSize="18sp"
+                    android:gravity="left|center_vertical"
+                    android:layout_gravity="start"
+                    android:layout_weight="1"
+                    android:paddingLeft="16dp" />
+                <Button
+                    android:id="@+id/hide"
+                    style="?attr/materialIconButtonStyle"
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_margin="8dp"
+                    app:icon="@drawable/ic_menu_open_rounded_filled_24dp"
+                    app:iconTint="?attr/colorOnSurfaceVariant" />
+            </LinearLayout>
+            <com.google.android.material.bottomnavigation.BottomNavigationView
+                android:layout_height="60dp"
+                android:layout_width="match_parent"
+                app:menu="@menu/sheet_options_menu"
+                android:background="@android:color/transparent"
+                android:id="@+id/btm_options"
+                app:labelVisibilityMode="unlabeled" />
+            <FrameLayout
+                android:layout_height="match_parent"
+                android:layout_width="match_parent"
+                android:orientation="vertical"
+                android:id="@+id/container">
+
+                <LinearLayout
+                    android:id="@+id/file_tree"
+                    android:layout_width="match_parent"
+                    android:layout_height="match_parent"
+                    android:orientation="horizontal">
+                <HorizontalScrollView
+                    android:layout_height="match_parent"
+                    android:layout_width="wrap_content"
+                    android:fillViewport="false">
+                    <androidx.core.widget.NestedScrollView
+                        android:layout_height="match_parent"
+                        android:layout_width="match_parent"
+                        android:gravity="center"
+                        android:id="@+id/content_file_tree"
+                        android:fillViewport="false">
+                        <!-- Where the file tree goes -->
+                        <com.zyron.filetree.widget.FileTreeView
+                            android:id="@+id/file_tree_view"
+                            android:layout_width="wrap_content"
+                            android:layout_height="match_parent" />
+                    </androidx.core.widget.NestedScrollView>
+                </HorizontalScrollView>
+                    <LinearLayout
+                        android:layout_width="match_parent"
+                        android:layout_height="match_parent"
+                        android:gravity="center"
+                        android:id="@+id/require_folder"
+                        android:orientation="vertical">
+                        <TextView
+                            android:layout_width="wrap_content"
+                            android:layout_height="wrap_content"
+                            android:text="No Workspace currently Set"/>
+                        <com.google.android.material.button.MaterialButton
+                            android:layout_width="wrap_content"
+                            android:layout_height="wrap_content"
+                            android:text="Open Folder"
+                            android:id="@+id/open_folder"
+                            app:icon="@drawable/ic_folder_rounded_filled_24dp"/>
+                    </LinearLayout>
+                </LinearLayout>
+                <LinearLayout
+                    android:layout_height="match_parent"
+                    android:layout_width="match_parent"
+                    android:gravity="center"
+                    android:id="@+id/content_git">
+                    <!-- Where the Git goes -->
+                    <TextView
+                        android:layout_height="wrap_content"
+                        android:layout_width="wrap_content"
+                        android:text="The Git Client is Coming Soon!" />
+                </LinearLayout>
+                <LinearLayout
+                    android:layout_height="match_parent"
+                    android:layout_width="match_parent"
+                    android:gravity="center"
+                    android:id="@+id/content_toolbox">
+
+                </LinearLayout>
+            </FrameLayout>
+
+
+        </LinearLayout>
+
+
+
+    </com.google.android.material.navigation.NavigationView>
 
     <com.google.android.material.navigation.NavigationView
         android:id="@+id/right_drawer_menu"
diff --git a/app/src/main/res/menu/sheet_options_menu.xml b/app/src/main/res/menu/sheet_options_menu.xml
new file mode 100644
index 0000000..a23c451
--- /dev/null
+++ b/app/src/main/res/menu/sheet_options_menu.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    <item
+        android:id="@+id/option_file_tree"
+        android:icon="@drawable/ic_folder_rounded_filled_24dp"
+        android:title="Files" />
+
+    <item
+        android:id="@+id/option_git"
+        android:icon="@drawable/git_24px"
+        android:title="Git" />
+
+
+</menu>
\ No newline at end of file
diff --git a/build.gradle.kts b/build.gradle.kts
index 3756278..922f551 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -1,4 +1,5 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 plugins {
     alias(libs.plugins.android.application) apply false
+    alias(libs.plugins.kotlin.android) apply false
 }
\ No newline at end of file
diff --git a/filetree/.gitignore b/filetree/.gitignore
new file mode 100755
index 0000000..42afabf
--- /dev/null
+++ b/filetree/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/filetree/build.gradle b/filetree/build.gradle
new file mode 100755
index 0000000..23135b2
--- /dev/null
+++ b/filetree/build.gradle
@@ -0,0 +1,43 @@
+plugins {
+    id 'com.android.library'
+}
+
+android {
+    namespace 'com.zyron.filetree'
+    compileSdk 34
+
+    defaultConfig {
+        minSdk 21
+        targetSdk 34
+
+        vectorDrawables {
+            useSupportLibrary true
+        }
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled true
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    buildFeatures {
+        viewBinding true
+
+    } 
+}
+
+dependencies {
+    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+    implementation 'com.google.android.material:material:1.12.0'
+    implementation 'androidx.appcompat:appcompat:1.7.0'
+    implementation 'androidx.core:core-ktx:1.13.1'  
+    implementation 'androidx.recyclerview:recyclerview:1.3.2'
+    implementation 'androidx.preference:preference-ktx:1.2.1'
+}
\ No newline at end of file
diff --git a/filetree/proguard-rules.pro b/filetree/proguard-rules.pro
new file mode 100755
index 0000000..481bb43
--- /dev/null
+++ b/filetree/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
\ No newline at end of file
diff --git a/filetree/src/main/AndroidManifest.xml b/filetree/src/main/AndroidManifest.xml
new file mode 100755
index 0000000..15e7c2a
--- /dev/null
+++ b/filetree/src/main/AndroidManifest.xml
@@ -0,0 +1 @@
+<manifest/>
\ No newline at end of file
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt b/filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt
new file mode 100755
index 0000000..15f20e7
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt
@@ -0,0 +1,199 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree
+
+import android.content.Context
+import android.util.Log
+import com.zyron.filetree.datamodel.FileTreeNode
+import com.zyron.filetree.map.ConcurrentFileMap
+import com.zyron.filetree.map.FileMapManager
+import java.io.File
+import java.nio.file.Files
+import java.nio.file.Paths
+import kotlinx.coroutines.*
+
+/** Listener interface to notify when the file tree is updated. */
+interface FileTreeAdapterUpdateListener {
+  fun onFileTreeUpdated(startPosition: Int, itemCount: Int)
+}
+
+/**
+ * FileTree represents a file tree structure with functionality to expand and collapse nodes.
+ *
+ * @property context The application context.
+ * @property rootDirectory The root directory path of the file tree.
+ */
+class FileTree(private val context: Context, private val rootDirectory: String) {
+
+  private val nodes: MutableList<FileTreeNode> = mutableListOf()
+  private val expandedNodes: MutableSet<FileTreeNode> = mutableSetOf()
+  private var adapterUpdateListener: FileTreeAdapterUpdateListener? = null
+  private val scope = CoroutineScope(Dispatchers.IO + SupervisorJob())
+  private var loading = false
+
+  /**
+   * Sets the listener for adapter updates.
+   *
+   * @param listener The listener to be notified of updates.
+   */
+  fun setAdapterUpdateListener(listener: FileTreeAdapterUpdateListener) {
+    this.adapterUpdateListener = listener
+  }
+
+  init {
+    val file = File(rootDirectory)
+    val rw = file.canRead() && file.canWrite()
+    if (!file.exists() || !rw) {
+      Log.e(
+        this::class.java.simpleName,
+        "The provided path: $rootDirectory is invalid or does not exist.",
+      )
+      Log.d(this::class.java.simpleName, "Continuing anyway...")
+    }
+
+    scope.coroutineContext[Job]?.invokeOnCompletion { exception ->
+      if (exception is CancellationException) {
+        Log.d(this::class.java.simpleName, "FileTree operation was cancelled.")
+      }
+    }
+
+    scope.launch {
+      try {
+        if (!loading) {
+          loading = true
+          val rootPath = Paths.get(rootDirectory)
+          val rootNode = FileTreeNode(rootPath.toFile())
+          addNode(rootNode)
+          FileMapManager.startFileMapping(nodes)
+          expandNode(rootNode)
+        }
+      } catch (e: Exception) {
+        Log.e(this::class.java.simpleName, "Error initializing FileTree: ${e.localizedMessage}", e)
+      }
+    }
+  }
+
+  /**
+   * Returns the list of all nodes in the file tree.
+   *
+   * @return List of FileTreeNode objects.
+   */
+  fun getNodes(): List<FileTreeNode> = nodes
+
+  /**
+   * Returns the set of expanded nodes in the file tree.
+   *
+   * @return Set of expanded FileTreeNode objects.
+   */
+  fun getExpandedNodes(): Set<FileTreeNode> = expandedNodes
+
+  /**
+   * Adds a node to the file tree and notifies the adapter.
+   *
+   * @param node The node to add.
+   * @param parent The parent node, if any.
+   */
+  private suspend fun addNode(node: FileTreeNode, parent: FileTreeNode? = null) {
+    node.parent = parent
+    nodes.add(node)
+    withContext(Dispatchers.Main) {
+      adapterUpdateListener?.onFileTreeUpdated(nodes.indexOf(node), 1)
+    }
+  }
+
+  /**
+   * Expands a node to display its children.
+   *
+   * @param node The node to expand.
+   */
+  fun expandNode(node: FileTreeNode) {
+    if (!node.isExpanded && Files.isDirectory(node.file.toPath())) {
+      node.isExpanded = true
+      scope.launch {
+        try {
+          expandedNodes.add(node)
+
+          val newNodes: List<FileTreeNode>? =
+            synchronized(ConcurrentFileMap.concurrentFileMap) {
+              ConcurrentFileMap.concurrentFileMap[node] ?: node.sortNode()
+            }
+
+          newNodes?.let {
+            if (it.isNotEmpty()) {
+              val insertIndex = nodes.indexOf(node) + 1
+              node.childrenStartIndex = insertIndex
+              node.childrenEndIndex = insertIndex + it.size
+              nodes.addAll(insertIndex, it)
+              withContext(Dispatchers.Main) {
+                adapterUpdateListener?.onFileTreeUpdated(node.childrenStartIndex, it.size)
+              }
+            }
+          }
+        } catch (e: Exception) {
+          Log.e(this::class.java.simpleName, "Error expanding node: ${e.localizedMessage}", e)
+        }
+      }
+    }
+  }
+
+  /**
+   * Collects all children of a node recursively.
+   *
+   * @param node The parent node.
+   * @param nodesToRemove The list to which all children will be added.
+   */
+  private fun collectAllChildren(node: FileTreeNode, nodesToRemove: MutableList<FileTreeNode>) {
+    val children = nodes.filter { it.parent == node }
+    nodesToRemove.addAll(children)
+    children.forEach { childNode -> collectAllChildren(childNode, nodesToRemove) }
+  }
+
+  /**
+   * Collapses a node, hiding its children.
+   *
+   * @param node The node to collapse.
+   */
+  fun collapseNode(node: FileTreeNode) {
+    if (node.isExpanded) {
+      node.isExpanded = false
+      scope.launch {
+        try {
+          expandedNodes.remove(node)
+          val nodesToRemove = mutableListOf<FileTreeNode>()
+          collectAllChildren(node, nodesToRemove)
+          nodesToRemove.forEach { childNode ->
+            childNode.isExpanded = false
+            expandedNodes.remove(childNode)
+          }
+          nodes.removeAll(nodesToRemove)
+          withContext(Dispatchers.Main) {
+            adapterUpdateListener?.onFileTreeUpdated(nodes.indexOf(node), nodesToRemove.size)
+          }
+        } catch (e: Exception) {
+          Log.e(this::class.java.simpleName, "Error collapsing node: ${e.localizedMessage}", e)
+        }
+      }
+    }
+  }
+
+  /** Cancels all coroutines related to this FileTree. */
+  fun cancelAllCoroutines() {
+    scope.cancel()
+  }
+
+  /** Cleans up resources when the FileTree is destroyed. */
+  fun onDestroy() {
+    scope.coroutineContext[Job]?.cancelChildren()
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt b/filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt
new file mode 100755
index 0000000..020175f
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt
@@ -0,0 +1,206 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.adapter
+
+import android.animation.ObjectAnimator
+import android.content.Context
+import android.util.TypedValue
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.view.animation.LinearInterpolator
+import androidx.core.content.ContextCompat
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import com.zyron.filetree.FileTree
+import com.zyron.filetree.FileTreeAdapterUpdateListener
+import com.zyron.filetree.R
+import com.zyron.filetree.callback.FileTreeDiffCallback
+import com.zyron.filetree.datamodel.FileTreeNode
+import com.zyron.filetree.events.FileTreeEventListener
+import com.zyron.filetree.provider.DefaultFileIconProvider
+import com.zyron.filetree.provider.FileTreeIconProvider
+import com.zyron.filetree.viewholder.FileTreeViewHolder
+
+/**
+ * Adapter for displaying a hierarchical list of files and directories in a RecyclerView.
+ *
+ * @param context The context for accessing resources and inflating views.
+ * @param fileTree The FileTree instance used for managing the file tree data.
+ * @param fileTreeIconProvider Provider for file and folder icons.
+ * @param fileTreeEventListener Listener for file and folder events (optional).
+ */
+class FileTreeAdapter(
+  private val context: Context,
+  private val fileTree: FileTree,
+  private val fileTreeIconProvider: FileTreeIconProvider,
+  private val fileTreeEventListener: FileTreeEventListener? = null,
+) :
+  ListAdapter<FileTreeNode, FileTreeViewHolder>(FileTreeDiffCallback()),
+  FileTreeAdapterUpdateListener {
+
+  @JvmOverloads
+  constructor(
+    context: Context,
+    fileTree: FileTree,
+    fileTreeEventListener: FileTreeEventListener? = null,
+  ) : this(context, fileTree, DefaultFileIconProvider(), fileTreeEventListener)
+
+  private var selectedItemPosition: Int = RecyclerView.NO_POSITION
+
+  /** Creates a new ViewHolder for a file tree item. */
+  override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): FileTreeViewHolder {
+    val view =
+      LayoutInflater.from(parent.context).inflate(R.layout.filetree_view_item, parent, false)
+    return FileTreeViewHolder(view)
+  }
+
+  /** Binds data to the ViewHolder for the given position. */
+  override fun onBindViewHolder(holder: FileTreeViewHolder, position: Int) {
+    val node = getItem(position)
+    onBindItemView(holder, node, position)
+  }
+
+  /** Configures the ViewHolder for the file tree item. */
+  private fun onBindItemView(holder: FileTreeViewHolder, node: FileTreeNode, position: Int) {
+    setItemViewLayout(holder, node)
+    setItemViewPadding(holder)
+    updateItemViewState(holder, node, position)
+
+    when {
+      node.file.isDirectory -> onBindDirectory(holder, node)
+      node.file.isFile -> onBindFile(holder, node)
+    }
+  }
+
+  /** Sets the layout parameters for the item view based on the node's level. */
+  private fun setItemViewLayout(holder: FileTreeViewHolder, node: FileTreeNode) {
+    val indentationPx =
+      TypedValue.applyDimension(
+          TypedValue.COMPLEX_UNIT_DIP,
+          (14 * node.level).toFloat(),
+          context.resources.displayMetrics,
+        )
+        .toInt()
+    val isLtr = context.resources.configuration.layoutDirection == View.LAYOUT_DIRECTION_LTR
+    val isRtl = context.resources.configuration.layoutDirection == View.LAYOUT_DIRECTION_RTL
+    val layoutParams = holder.itemView.layoutParams as ViewGroup.MarginLayoutParams
+
+    if (isLtr) {
+      layoutParams.leftMargin = indentationPx
+      layoutParams.rightMargin = 0
+    } else if (isRtl) {
+      layoutParams.rightMargin = indentationPx
+      layoutParams.leftMargin = 0
+    }
+
+    holder.itemView.layoutParams = layoutParams
+  }
+
+  /** Sets padding for the item view and its child views. */
+  private fun setItemViewPadding(holder: FileTreeViewHolder) {
+    holder.itemView.setPadding(4, 8, 4, 8)
+    holder.chevronIconView.setPadding(4, 0, 2, 0)
+    holder.fileIconView.setPadding(2, 0, 4, 0)
+    holder.fileNameView.setPadding(6, 7, 7, 6)
+  }
+
+  /** Updates the state of the item view based on whether it is selected and expanded. */
+  private fun updateItemViewState(holder: FileTreeViewHolder, node: FileTreeNode, position: Int) {
+    holder.itemView.setBackgroundResource(R.drawable.item_view_background)
+    holder.itemView.isSelected =
+      position == selectedItemPosition && node.isExpanded && node.file.isDirectory
+  }
+
+  /** Binds a directory node to the ViewHolder. */
+  private fun onBindDirectory(holder: FileTreeViewHolder, node: FileTreeNode) {
+    val isLtr = context.resources.configuration.layoutDirection == View.LAYOUT_DIRECTION_LTR
+    val isRtl = context.resources.configuration.layoutDirection == View.LAYOUT_DIRECTION_RTL
+
+    val targetRotation =
+      when {
+        node.isExpanded && isLtr -> 90f
+        node.isExpanded && isRtl -> 90f
+        !node.isExpanded && isLtr -> 0f
+        !node.isExpanded && isRtl -> 180f
+        else -> 0f
+      }
+
+    holder.chevronIconView.setImageDrawable(
+      ContextCompat.getDrawable(context, fileTreeIconProvider.getChevronIcon())
+    )
+    holder.chevronIconView.rotation = targetRotation
+    holder.chevronIconView.visibility = View.VISIBLE
+    holder.fileIconView.setImageDrawable(
+      ContextCompat.getDrawable(context, fileTreeIconProvider.getIconForFolder(node.file))
+    )
+    holder.fileNameView.text = node.file.name
+
+    val currentRotation = holder.chevronIconView.rotation
+    if (currentRotation != targetRotation) {
+      val rotationAnimator =
+        ObjectAnimator.ofFloat(holder.chevronIconView, "rotation", currentRotation, targetRotation)
+          .apply {
+            duration = 300
+            interpolator = LinearInterpolator()
+          }
+      rotationAnimator.setDuration(300)
+      rotationAnimator.start()
+    }
+
+    holder.itemView.setOnClickListener {
+      val previousPosition = selectedItemPosition
+      if (node.isExpanded) {
+        fileTree.collapseNode(node)
+      } else {
+        fileTree.expandNode(node)
+      }
+      selectedItemPosition = holder.bindingAdapterPosition
+      notifyItemChanged(selectedItemPosition)
+      notifyItemChanged(previousPosition)
+    }
+
+    holder.itemView.setOnLongClickListener {
+      fileTreeEventListener?.onFolderLongClick(node.file) ?: false
+    }
+  }
+
+  /** Binds a file node to the ViewHolder. */
+  private fun onBindFile(holder: FileTreeViewHolder, node: FileTreeNode) {
+    holder.chevronIconView.setImageDrawable(
+      ContextCompat.getDrawable(context, fileTreeIconProvider.getChevronIcon())
+    )
+    holder.chevronIconView.visibility = View.INVISIBLE
+    holder.fileIconView.setImageDrawable(
+      ContextCompat.getDrawable(context, fileTreeIconProvider.getIconForFile(node.file))
+    )
+    holder.fileNameView.text = node.file.name
+
+    holder.itemView.setOnClickListener { fileTreeEventListener?.onFileClick(node.file) }
+
+    holder.itemView.setOnLongClickListener {
+      fileTreeEventListener?.onFileLongClick(node.file) ?: false
+    }
+  }
+
+  /** Updates the RecyclerView when the file tree changes. */
+  override fun onFileTreeUpdated(startPosition: Int, itemCount: Int) {
+    notifyItemRangeChanged(startPosition, itemCount)
+  }
+
+  /** Submits a new list to be displayed. */
+  override fun submitList(list: MutableList<FileTreeNode>?) {
+    super.submitList(list?.toList())
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt b/filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt
new file mode 100755
index 0000000..45b7039
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt
@@ -0,0 +1,43 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.callback
+
+import androidx.recyclerview.widget.DiffUtil
+import com.zyron.filetree.datamodel.FileTreeNode
+
+/** A DiffUtil.ItemCallback implementation for comparing FileTreeNode objects. */
+class FileTreeDiffCallback : DiffUtil.ItemCallback<FileTreeNode>() {
+
+  /**
+   * Determines if two FileTreeNode items represent the same file by comparing their absolute paths.
+   *
+   * @param oldItem The previous FileTreeNode item.
+   * @param newItem The new FileTreeNode item.
+   * @return True if the two items represent the same file, false otherwise.
+   */
+  override fun areItemsTheSame(oldItem: FileTreeNode, newItem: FileTreeNode): Boolean {
+    return oldItem.file.absolutePath == newItem.file.absolutePath
+  }
+
+  /**
+   * Determines if the contents of two FileTreeNode items are the same.
+   *
+   * @param oldItem The previous FileTreeNode item.
+   * @param newItem The new FileTreeNode item.
+   * @return True if the contents of the two items are the same, false otherwise.
+   */
+  override fun areContentsTheSame(oldItem: FileTreeNode, newItem: FileTreeNode): Boolean {
+    return oldItem == newItem
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt b/filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt
new file mode 100755
index 0000000..16f0c58
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt
@@ -0,0 +1,61 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.datamodel
+
+import java.io.File
+
+/**
+ * Represents a node in a file tree, corresponding to a file or directory.
+ *
+ * @property file The file or directory represented by this node.
+ * @property parent The parent node of this node in the file tree.
+ * @property level The depth level of this node in the file tree.
+ */
+data class FileTreeNode(var file: File, var parent: FileTreeNode? = null, var level: Int = 0) {
+  var isExpanded: Boolean = false
+  var childrenStartIndex: Int = 0
+  var childrenEndIndex: Int = 0
+  var childrenLoaded: Boolean = false
+
+  /**
+   * Sorts the children of this node, separating directories from files and sorting them
+   * alphabetically.
+   *
+   * @return A list of FileTreeNode objects representing the sorted children.
+   */
+  fun sortNode(): List<FileTreeNode> {
+    val children =
+      file
+        .listFiles()
+        ?.asSequence()
+        ?.partition { it.isDirectory }
+        ?.let { (directories, files) ->
+          (directories.sortedBy { it.name.lowercase() } + files.sortedBy { it.name.lowercase() })
+        } ?: emptyList()
+    return children.map { childFile ->
+      FileTreeNode(file = childFile, parent = this, level = level + 1)
+    }
+  }
+
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    if (other == null || javaClass != other.javaClass) return false
+    other as FileTreeNode
+    return file.absolutePath == other.file.absolutePath
+  }
+
+  override fun hashCode(): Int {
+    return file.absolutePath.hashCode()
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt b/filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt
new file mode 100755
index 0000000..6d13653
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt
@@ -0,0 +1,58 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.events
+
+import java.io.File
+
+/** Interface to listen for events within a file tree, including clicks and updates. */
+interface FileTreeEventListener {
+
+  /**
+   * Called when a file is clicked.
+   *
+   * @param file The file that was clicked.
+   */
+  fun onFileClick(file: File)
+
+  /**
+   * Called when a folder is clicked.
+   *
+   * @param folder The folder that was clicked.
+   */
+  fun onFolderClick(folder: File)
+
+  /**
+   * Called when a file is long-clicked.
+   *
+   * @param file The file that was long-clicked.
+   * @return True if the long-click event was handled, false otherwise.
+   */
+  fun onFileLongClick(file: File): Boolean
+
+  /**
+   * Called when a folder is long-clicked.
+   *
+   * @param folder The folder that was long-clicked.
+   * @return True if the long-click event was handled, false otherwise.
+   */
+  fun onFolderLongClick(folder: File): Boolean
+
+  /**
+   * Called when the file tree view is updated.
+   *
+   * @param startPosition The starting position of the update.
+   * @param itemCount The number of items updated.
+   */
+  fun onFileTreeViewUpdated(startPosition: Int, itemCount: Int)
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt b/filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt
new file mode 100755
index 0000000..6bcf648
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt
@@ -0,0 +1,119 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.map
+
+import com.zyron.filetree.datamodel.FileTreeNode
+import java.util.concurrent.ConcurrentHashMap
+import java.util.concurrent.Executors
+import java.util.concurrent.Future
+import java.util.concurrent.ScheduledExecutorService
+import java.util.concurrent.TimeUnit
+
+/**
+ * Manages a cache of file nodes for efficient access and manipulation using concurrency.
+ *
+ * @param nodes A list of root nodes to be processed and cached.
+ * @param maxSize The maximum size of the cache before trimming.
+ */
+class ConcurrentFileMap(private val nodes: List<FileTreeNode>, private val maxSize: Int = 100) :
+  Runnable {
+
+  companion object {
+    val concurrentFileMap: MutableMap<FileTreeNode, List<FileTreeNode>> = ConcurrentHashMap()
+  }
+
+  private val cache = ConcurrentHashMap<FileTreeNode, List<FileTreeNode>>(maxSize)
+  private val executor: ScheduledExecutorService =
+    Executors.newScheduledThreadPool(Runtime.getRuntime().availableProcessors())
+
+  init {
+    // Schedule cache trimming at fixed intervals
+    executor.scheduleAtFixedRate(::trimCache, 10, 10, TimeUnit.SECONDS)
+  }
+
+  /**
+   * Retrieves a list of child nodes for a given file node from the cache.
+   *
+   * @param node The parent file node.
+   * @return A list of child file nodes, or null if the node is not in the cache.
+   */
+  fun get(node: FileTreeNode): List<FileTreeNode>? {
+    return cache[node]
+  }
+
+  /**
+   * Adds a file node and its children to the cache.
+   *
+   * @param node The parent file node.
+   * @param result The list of child file nodes.
+   */
+  fun put(node: FileTreeNode, result: List<FileTreeNode>) {
+    cache[node] = result
+    if (cache.size > maxSize) {
+      trimCache()
+    }
+  }
+
+  /** Clears the entire cache. */
+  fun clear() {
+    cache.clear()
+  }
+
+  /**
+   * Processes a list of file nodes asynchronously to populate the cache.
+   *
+   * @param nodes The list of file nodes to process.
+   */
+  private fun processNodes(nodes: List<FileTreeNode>) {
+    val futures = mutableListOf<Future<*>>()
+    for (node in nodes) {
+      val future =
+        executor.submit {
+          val nodeList = node.sortNode()
+          put(node, nodeList)
+          processNodes(nodeList)
+        }
+      futures.add(future)
+    }
+    futures.forEach { it.get() }
+  }
+
+  /** Trims the cache to the specified maximum size by removing excess entries. */
+  private fun trimCache() {
+    if (cache.size > maxSize) {
+      val keysToRemove = cache.keys.take(cache.size - maxSize)
+      for (key in keysToRemove) {
+        cache.remove(key)
+      }
+    }
+  }
+
+  /** Entry point for processing nodes when this Runnable is executed. */
+  override fun run() {
+    processNodes(nodes)
+  }
+
+  /** Shuts down the executor service and cancels all running tasks. */
+  fun shutdown() {
+    executor.shutdown()
+    try {
+      if (!executor.awaitTermination(60, TimeUnit.SECONDS)) {
+        executor.shutdownNow()
+      }
+    } catch (ex: InterruptedException) {
+      executor.shutdownNow()
+      Thread.currentThread().interrupt()
+    }
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt b/filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt
new file mode 100755
index 0000000..038a439
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt
@@ -0,0 +1,59 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.map
+
+import android.util.Log
+import com.zyron.filetree.datamodel.FileTreeNode
+import java.util.concurrent.Executors
+import java.util.concurrent.Future
+
+/** Manages the mapping of file nodes using a single-threaded executor. */
+object FileMapManager {
+  private var fileCacheFuture: Future<*>? = null
+  private val executor = Executors.newSingleThreadExecutor()
+
+  /** Stops the current file mapping task, if one is running. */
+  fun stopFileMapping() {
+    fileCacheFuture?.cancel(true)
+    fileCacheFuture = null
+    Log.i(this::class.java.simpleName, "FileMapping stopped")
+  }
+
+  /**
+   * Starts the file mapping process on a separate thread.
+   *
+   * @param nodes The list of root nodes to process.
+   * @param priority Optional priority setting for the mapping thread.
+   */
+  fun startFileMapping(nodes: List<FileTreeNode>, priority: Int? = null) {
+    if (fileCacheFuture == null) {
+      fileCacheFuture =
+        executor
+          .submit {
+            try {
+              val fileCache = ConcurrentFileMap(nodes)
+              fileCache.run()
+            } catch (e: InterruptedException) {
+              Thread.currentThread().interrupt()
+            } catch (e: Exception) {
+              Log.e(this::class.java.simpleName, "Error in FileMapping", e)
+            }
+          }
+          .apply { priority?.let { (this as Thread).priority = it } }
+      Log.i(this::class.java.simpleName, "FileMapping started")
+    } else {
+      Log.e(this::class.java.simpleName, "FileMapping is already running; this might cause issues")
+    }
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt b/filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt
new file mode 100755
index 0000000..4501bef
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt
@@ -0,0 +1,100 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.provider
+
+import com.zyron.filetree.R
+import java.io.File
+
+/**
+ * Default implementation of the [FileTreeIconProvider] interface. Provides default icons for
+ * chevrons, folders, and files, as well as custom icons based on folder names and file extensions.
+ */
+class DefaultFileIconProvider : FileTreeIconProvider {
+
+  /**
+   * Returns the resource ID for the chevron icon used in the file tree.
+   *
+   * @return Resource ID for the chevron icon.
+   */
+  override fun getChevronIcon(): Int {
+    return R.drawable.ic_chevron
+  }
+
+  /**
+   * Returns the resource ID for the default folder icon.
+   *
+   * @return Resource ID for the default folder icon.
+   */
+  override fun getDefaultFolderIcon(): Int {
+    return R.drawable.ic_folder
+  }
+
+  /**
+   * Returns the resource ID for the default file icon.
+   *
+   * @return Resource ID for the default file icon.
+   */
+  override fun getDefaultFileIcon(): Int {
+    return R.drawable.ic_file
+  }
+
+  /**
+   * Returns the resource ID for the folder icon based on the folder name.
+   *
+   * @param folder The folder whose icon is to be determined.
+   * @return Resource ID for the folder icon.
+   */
+  override fun getIconForFolder(folder: File): Int {
+    return when (folder.name) {
+      "app" -> R.drawable.ic_folder
+      "src" -> R.drawable.ic_folder
+      "kotlin" -> R.drawable.ic_folder
+      "java" -> R.drawable.ic_folder
+      "res" -> R.drawable.ic_folder
+      else -> getDefaultFolderIcon()
+    }
+  }
+
+  /**
+   * Returns the resource ID for the file icon based on the file name.
+   *
+   * @param file The file whose icon is to be determined.
+   * @return Resource ID for the file icon.
+   */
+  override fun getIconForFile(file: File): Int {
+    return when (file.name) {
+      "gradlew.bat" -> R.drawable.ic_file
+      "gradlew" -> R.drawable.ic_file
+      "settings.gradle" -> R.drawable.ic_file
+      "build.gradle" -> R.drawable.ic_file
+      "gradle.properties" -> R.drawable.ic_file
+      else -> getIconForExtension(file.extension)
+    }
+  }
+
+  /**
+   * Returns the resource ID for the file icon based on the file extension.
+   *
+   * @param extension The extension of the file whose icon is to be determined.
+   * @return Resource ID for the file icon.
+   */
+  override fun getIconForExtension(extension: String): Int {
+    return when (extension) {
+      "xml" -> R.drawable.ic_file
+      "java" -> R.drawable.ic_file
+      "kt" -> R.drawable.ic_file
+      else -> getDefaultFileIcon()
+    }
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt b/filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt
new file mode 100755
index 0000000..b47df3b
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt
@@ -0,0 +1,69 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.provider
+
+import androidx.annotation.DrawableRes
+import java.io.File
+
+/**
+ * Interface for providing icons for files and folders in a file tree. Implementations of this
+ * interface should provide specific icons based on the type of file or folder and file extensions.
+ */
+interface FileTreeIconProvider {
+
+  /**
+   * Returns the resource ID for the chevron icon used in the file tree.
+   *
+   * @return Resource ID for the chevron icon.
+   */
+  @DrawableRes fun getChevronIcon(): Int
+
+  /**
+   * Returns the resource ID for the default folder icon.
+   *
+   * @return Resource ID for the default folder icon.
+   */
+  @DrawableRes fun getDefaultFolderIcon(): Int
+
+  /**
+   * Returns the resource ID for the default file icon.
+   *
+   * @return Resource ID for the default file icon.
+   */
+  @DrawableRes fun getDefaultFileIcon(): Int
+
+  /**
+   * Returns the resource ID for the folder icon based on the folder's name.
+   *
+   * @param folder The folder whose icon is to be determined.
+   * @return Resource ID for the folder icon.
+   */
+  @DrawableRes fun getIconForFolder(folder: File): Int
+
+  /**
+   * Returns the resource ID for the file icon based on the file's name.
+   *
+   * @param file The file whose icon is to be determined.
+   * @return Resource ID for the file icon.
+   */
+  @DrawableRes fun getIconForFile(file: File): Int
+
+  /**
+   * Returns the resource ID for the file icon based on the file's extension.
+   *
+   * @param extension The extension of the file whose icon is to be determined.
+   * @return Resource ID for the file icon.
+   */
+  @DrawableRes fun getIconForExtension(extension: String): Int
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt b/filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt
new file mode 100755
index 0000000..127aec5
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt
@@ -0,0 +1,31 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.utils
+
+import android.os.Handler
+import android.os.Looper
+
+/** Utility object providing helper methods for running tasks on the main thread. */
+object Utils {
+  private val handler = Handler(Looper.getMainLooper())
+
+  /**
+   * Posts a Runnable to be executed on the main (UI) thread.
+   *
+   * @param runnable The Runnable to be executed on the UI thread.
+   */
+  fun runOnUiThread(runnable: Runnable) {
+    handler.post(runnable)
+  }
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt b/filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt
new file mode 100755
index 0000000..25324f3
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt
@@ -0,0 +1,41 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.viewholder
+
+// import com.google.android.material.imageview.ShapeableImageView
+// import com.google.android.material.textview.MaterialTextView
+import android.view.View
+import android.widget.ImageView
+import android.widget.TextView
+import androidx.recyclerview.widget.RecyclerView
+import com.zyron.filetree.R
+
+/**
+ * ViewHolder for the FileTreeRecyclerView.
+ *
+ * Holds references to the views for each item in the RecyclerView, including the chevron icon, file
+ * icon, and file name.
+ *
+ * @param itemView The view of the item in the RecyclerView.
+ */
+class FileTreeViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
+  /** View for the chevron icon indicating expandable or collapsible state. */
+  val chevronIconView: ImageView = itemView.findViewById(R.id.chevronIconView)
+
+  /** View for the file icon representing the type of file. */
+  val fileIconView: ImageView = itemView.findViewById(R.id.fileIconView)
+
+  /** View for displaying the name of the file or folder. */
+  val fileNameView: TextView = itemView.findViewById(R.id.fileNameView)
+}
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt b/filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt
new file mode 100755
index 0000000..918ee2d
--- /dev/null
+++ b/filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt
@@ -0,0 +1,165 @@
+/**
+ * Copyright 2024 Zyron Official.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package com.zyron.filetree.widget
+
+import android.content.Context
+import android.util.AttributeSet
+import android.view.animation.AnimationUtils
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import androidx.recyclerview.widget.RecyclerView.RecycledViewPool
+import com.zyron.filetree.FileTree
+import com.zyron.filetree.FileTreeAdapterUpdateListener
+import com.zyron.filetree.R
+import com.zyron.filetree.adapter.FileTreeAdapter
+import com.zyron.filetree.events.FileTreeEventListener
+import com.zyron.filetree.map.ConcurrentFileMap
+import com.zyron.filetree.provider.FileTreeIconProvider
+import com.zyron.filetree.utils.Utils.runOnUiThread
+
+/**
+ * FileTreeView extends RecyclerView to represent a file tree structure. Handles initialization,
+ * layout, and interactions specific to a file tree.
+ */
+class FileTreeView : RecyclerView {
+
+  private var path: String? = null
+  private var fileTree: FileTree? = null
+
+  private var recyclerItemViewCount: Int = 200
+  private var recyclerItemViewEnabled: Boolean = true
+  private var itemViewCacheSize: Int = 100
+  private var itemViewCachingEnabled: Boolean = true
+  private var fileMapMaxSize: Int = 150
+  private var fileMapEnabled: Boolean = true
+  private var fileTreeAnimation: Int = 4
+  private var fileTreeAnimationEnabled: Boolean = true
+  private var animationResId: Int = 4
+
+  private lateinit var recycledViewPool: RecycledViewPool
+
+  constructor(context: Context) : super(context) {
+    init(context, null)
+  }
+
+  constructor(context: Context, attrs: AttributeSet?) : super(context, attrs) {
+    init(context, attrs)
+  }
+
+  constructor(
+    context: Context,
+    attrs: AttributeSet?,
+    defstyleAttrs: Int,
+  ) : super(context, attrs, defstyleAttrs) {
+    init(context, attrs)
+  }
+
+  /**
+   * Initializes the FileTreeView with given attributes.
+   *
+   * @param context The context associated with the view.
+   * @param attrs The attributes from the XML layout.
+   */
+  private fun init(context: Context, attrs: AttributeSet?) {
+    attrs?.let {
+      val attribute = context.obtainStyledAttributes(it, R.styleable.FileTreeView)
+      recyclerItemViewCount =
+        attribute.getInteger(R.styleable.FileTreeView_recyclerItemViewCount, 200)
+      recyclerItemViewEnabled =
+        attribute.getBoolean(R.styleable.FileTreeView_recyclerItemViewEnabled, true)
+      itemViewCacheSize = attribute.getInteger(R.styleable.FileTreeView_itemViewCacheSize, 100)
+      itemViewCachingEnabled =
+        attribute.getBoolean(R.styleable.FileTreeView_itemViewCachingEnabled, true)
+      fileMapMaxSize = attribute.getInteger(R.styleable.FileTreeView_fileMapMaxSize, 150)
+      fileMapEnabled = attribute.getBoolean(R.styleable.FileTreeView_fileMapEnabled, true)
+      fileTreeAnimation = attribute.getInteger(R.styleable.FileTreeView_fileTreeAnimation, 4)
+      fileTreeAnimationEnabled =
+        attribute.getBoolean(R.styleable.FileTreeView_fileTreeAnimationEnabled, true)
+      attribute.recycle()
+    }
+    if (itemViewCachingEnabled) {
+      setItemViewCacheSize(itemViewCacheSize)
+    }
+    setAnimation(fileTreeAnimation)
+  }
+
+  /**
+   * Sets the animation for the FileTreeView based on the provided animation type.
+   *
+   * @param fileTreeAnimation The type of animation to use.
+   */
+  private fun setAnimation(fileTreeAnimation: Int) {
+    animationResId =
+      when (fileTreeAnimation) {
+        0 -> R.anim.fall_down_animation
+        1 -> R.anim.rotate_in_animation
+        2 -> R.anim.scale_up_animation
+        3 -> R.anim.slide_in_animation
+        else -> R.anim.default_animation
+      }
+  }
+
+  /**
+   * Initializes the FileTree with a given path and optional listeners.
+   *
+   * @param path The root path for the file tree.
+   * @param fileTreeEventListener Optional listener for file tree events.
+   * @param fileTreeIconProvider Optional provider for custom file tree icons.
+   */
+  fun initializeFileTree(
+    path: String,
+    fileTreeEventListener: FileTreeEventListener? = null,
+    fileTreeIconProvider: FileTreeIconProvider? = null,
+  ) {
+    this.path = path
+    fileTree = FileTree(context, path)
+
+    val fileTreeAdapter =
+      when {
+        fileTreeEventListener == null -> FileTreeAdapter(context, fileTree!!)
+        fileTreeIconProvider != null ->
+          FileTreeAdapter(context, fileTree!!, fileTreeIconProvider, fileTreeEventListener)
+        else -> FileTreeAdapter(context, fileTree!!, fileTreeEventListener)
+      }
+
+    recycledViewPool = RecycledViewPool()
+    this.setRecycledViewPool(recycledViewPool)
+
+    if (recyclerItemViewEnabled) {
+      recycledViewPool.setMaxRecycledViews(0, recyclerItemViewCount)
+    }
+
+    if (fileMapEnabled) {
+      val concurrentFileMap = ConcurrentFileMap(fileTree!!.getNodes(), fileMapMaxSize)
+      Thread(concurrentFileMap).start()
+    }
+
+    if (fileTreeAnimationEnabled) {
+      val animation = AnimationUtils.loadLayoutAnimation(context, animationResId)
+      this.layoutAnimation = animation
+    }
+
+    layoutManager = LinearLayoutManager(context)
+    adapter = fileTreeAdapter
+
+    fileTree!!.setAdapterUpdateListener(
+      object : FileTreeAdapterUpdateListener {
+        override fun onFileTreeUpdated(startPosition: Int, itemCount: Int) {
+          fileTreeEventListener?.onFileTreeViewUpdated(startPosition, itemCount)
+          runOnUiThread { fileTreeAdapter.submitList(fileTree!!.getNodes().toMutableList()) }
+        }
+      }
+    )
+  }
+}
diff --git a/filetree/src/main/res/anim/default_anim.xml b/filetree/src/main/res/anim/default_anim.xml
new file mode 100755
index 0000000..6c36622
--- /dev/null
+++ b/filetree/src/main/res/anim/default_anim.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set xmlns:android="http://schemas.android.com/apk/res/android"
+     android:interpolator="@android:interpolator/accelerate_decelerate"
+     android:duration="500">
+</set>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/default_animation.xml b/filetree/src/main/res/anim/default_animation.xml
new file mode 100755
index 0000000..068b7b4
--- /dev/null
+++ b/filetree/src/main/res/anim/default_animation.xml
@@ -0,0 +1,5 @@
+<layoutAnimation xmlns:android="http://schemas.android.com/apk/res/android"
+    android:animationOrder="normal"
+    android:delay="10%"
+    android:animation="@anim/default_anim" >
+</layoutAnimation>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/fall_down.xml b/filetree/src/main/res/anim/fall_down.xml
new file mode 100755
index 0000000..c4259d4
--- /dev/null
+++ b/filetree/src/main/res/anim/fall_down.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set xmlns:android="http://schemas.android.com/apk/res/android"
+     android:interpolator="@android:interpolator/accelerate_decelerate"
+     android:duration="500">
+    
+    <alpha
+        android:fromAlpha="0.0"
+        android:toAlpha="1.0"
+        android:duration="300" />    
+
+    <translate
+        android:fromYDelta="-100%"
+        android:toYDelta="0"
+        android:duration="300" />
+    
+</set>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/fall_down_animation.xml b/filetree/src/main/res/anim/fall_down_animation.xml
new file mode 100755
index 0000000..d2c4669
--- /dev/null
+++ b/filetree/src/main/res/anim/fall_down_animation.xml
@@ -0,0 +1,5 @@
+<layoutAnimation xmlns:android="http://schemas.android.com/apk/res/android"
+    android:animationOrder="normal"
+    android:delay="10%"
+    android:animation="@anim/fall_down" >
+</layoutAnimation>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/rotate_in.xml b/filetree/src/main/res/anim/rotate_in.xml
new file mode 100755
index 0000000..0bc00bb
--- /dev/null
+++ b/filetree/src/main/res/anim/rotate_in.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <alpha android:fromAlpha="0"
+        android:toAlpha="1"
+        android:duration="400"/>
+
+    <rotate android:fromDegrees="-10"
+        android:toDegrees="0"
+        android:pivotX="0%"
+        android:pivotY="100%"
+        android:duration="400" />
+
+</set>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/rotate_in_animation.xml b/filetree/src/main/res/anim/rotate_in_animation.xml
new file mode 100755
index 0000000..d23db5b
--- /dev/null
+++ b/filetree/src/main/res/anim/rotate_in_animation.xml
@@ -0,0 +1,5 @@
+<layoutAnimation xmlns:android="http://schemas.android.com/apk/res/android"
+    android:animationOrder="normal"
+    android:delay="10%"
+    android:animation="@anim/rotate_in" >
+</layoutAnimation>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/scale_up.xml b/filetree/src/main/res/anim/scale_up.xml
new file mode 100755
index 0000000..612680d
--- /dev/null
+++ b/filetree/src/main/res/anim/scale_up.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <alpha android:fromAlpha="0"
+        android:toAlpha="1"
+        android:duration="400"/>
+
+    <scale android:fromYScale="0"
+        android:fromXScale="0"
+        android:toXScale="1"
+        android:toYScale="1"
+        android:pivotX="50%"
+        android:pivotY="50%"
+        android:duration="400" />
+
+</set>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/scale_up_animation.xml b/filetree/src/main/res/anim/scale_up_animation.xml
new file mode 100755
index 0000000..c4e50d7
--- /dev/null
+++ b/filetree/src/main/res/anim/scale_up_animation.xml
@@ -0,0 +1,5 @@
+<layoutAnimation xmlns:android="http://schemas.android.com/apk/res/android"
+    android:animationOrder="normal"
+    android:delay="10%"
+    android:animation="@anim/scale_up" >
+</layoutAnimation>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/slide_in.xml b/filetree/src/main/res/anim/slide_in.xml
new file mode 100755
index 0000000..f967a6f
--- /dev/null
+++ b/filetree/src/main/res/anim/slide_in.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <alpha android:fromAlpha="0"
+        android:toAlpha="1"
+        android:duration="400"/>
+
+    <translate android:fromXDelta="-100%"
+        android:toXDelta="0%"
+        android:duration="400" />
+
+</set>
\ No newline at end of file
diff --git a/filetree/src/main/res/anim/slide_in_animation.xml b/filetree/src/main/res/anim/slide_in_animation.xml
new file mode 100755
index 0000000..6943667
--- /dev/null
+++ b/filetree/src/main/res/anim/slide_in_animation.xml
@@ -0,0 +1,5 @@
+<layoutAnimation xmlns:android="http://schemas.android.com/apk/res/android"
+    android:animationOrder="normal"
+    android:delay="10%"
+    android:animation="@anim/slide_in" >
+</layoutAnimation>
\ No newline at end of file
diff --git a/filetree/src/main/res/drawable/ic_chevron.xml b/filetree/src/main/res/drawable/ic_chevron.xml
new file mode 100755
index 0000000..9aed824
--- /dev/null
+++ b/filetree/src/main/res/drawable/ic_chevron.xml
@@ -0,0 +1,11 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+        android:width="24dp"
+        android:height="24dp"
+        android:viewportWidth="960"
+        android:viewportHeight="960"
+        android:tint="?attr/colorControlNormal"
+        android:autoMirrored="false">
+    
+    <path android:fillColor="@android:color/white"
+          android:pathData="M517.85,480L354.92,317.08Q346.62,308.77 346.42,296.19Q346.23,283.62 354.92,274.92Q363.62,266.23 376,266.23Q388.38,266.23 397.08,274.92L576.85,454.69Q582.46,460.31 584.77,466.54Q587.08,472.77 587.08,480Q587.08,487.23 584.77,493.46Q582.46,499.69 576.85,505.31L397.08,685.08Q388.77,693.38 376.19,693.58Q363.62,693.77 354.92,685.08Q346.23,676.38 346.23,664Q346.23,651.62 354.92,642.92L517.85,480Z" />
+</vector>
\ No newline at end of file
diff --git a/filetree/src/main/res/drawable/ic_file.xml b/filetree/src/main/res/drawable/ic_file.xml
new file mode 100755
index 0000000..f93830f
--- /dev/null
+++ b/filetree/src/main/res/drawable/ic_file.xml
@@ -0,0 +1,11 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="960"
+    android:viewportHeight="960"
+    android:tint="?attr/colorControlNormal"
+    android:autoMirrored="true">
+  <path
+      android:fillColor="@android:color/white"
+      android:pathData="M240,880Q207,880 183.5,856.5Q160,833 160,800L160,160Q160,127 183.5,103.5Q207,80 240,80L527,80Q543,80 557.5,86Q572,92 583,103L777,297Q788,308 794,322.5Q800,337 800,353L800,800Q800,833 776.5,856.5Q753,880 720,880L240,880ZM520,320L520,160L240,160Q240,160 240,160Q240,160 240,160L240,800Q240,800 240,800Q240,800 240,800L720,800Q720,800 720,800Q720,800 720,800L720,360L560,360Q543,360 531.5,348.5Q520,337 520,320ZM240,160L240,160L240,320Q240,337 240,348.5Q240,360 240,360L240,360L240,160L240,320Q240,337 240,348.5Q240,360 240,360L240,360L240,800Q240,800 240,800Q240,800 240,800L240,800Q240,800 240,800Q240,800 240,800L240,160Q240,160 240,160Q240,160 240,160Z"/>
+</vector>
diff --git a/filetree/src/main/res/drawable/ic_folder.xml b/filetree/src/main/res/drawable/ic_folder.xml
new file mode 100755
index 0000000..a1e978b
--- /dev/null
+++ b/filetree/src/main/res/drawable/ic_folder.xml
@@ -0,0 +1,10 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="960"
+    android:viewportHeight="960"
+    android:tint="?attr/colorControlNormal">
+  <path
+      android:fillColor="@android:color/white"
+      android:pathData="M160,800Q127,800 103.5,776.5Q80,753 80,720L80,240Q80,207 103.5,183.5Q127,160 160,160L367,160Q383,160 397.5,166Q412,172 423,183L480,240L800,240Q833,240 856.5,263.5Q880,287 880,320L880,720Q880,753 856.5,776.5Q833,800 800,800L160,800ZM160,720L800,720Q800,720 800,720Q800,720 800,720L800,320Q800,320 800,320Q800,320 800,320L447,320L367,240Q367,240 367,240Q367,240 367,240L160,240Q160,240 160,240Q160,240 160,240L160,720Q160,720 160,720Q160,720 160,720ZM160,720Q160,720 160,720Q160,720 160,720L160,240Q160,240 160,240Q160,240 160,240L160,240Q160,240 160,240Q160,240 160,240L160,320L160,320Q160,320 160,320Q160,320 160,320L160,720Q160,720 160,720Q160,720 160,720Z"/>
+</vector>
diff --git a/filetree/src/main/res/drawable/item_activated_background.xml b/filetree/src/main/res/drawable/item_activated_background.xml
new file mode 100755
index 0000000..b6ef38d
--- /dev/null
+++ b/filetree/src/main/res/drawable/item_activated_background.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+ <!-- 
+ ~ Copyright 2024 Zyron Official.
+ ~
+ ~ Licensed under the Apache License, Version 2.0 (the "License");
+ ~ you may not use this file except in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing, software
+ ~ distributed under the License is distributed on an "AS IS" BASIS,
+ ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ~ See the License for the specific language governing permissions and
+ ~ limitations under the License.
+ -->
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:top="0dp" android:bottom="0dp">
+        <shape android:shape="rectangle">
+            <solid android:color="@android:color/transparent" />
+            <corners android:radius="50dp" />
+        </shape>
+    </item>
+</layer-list>
\ No newline at end of file
diff --git a/filetree/src/main/res/drawable/item_selected_background.xml b/filetree/src/main/res/drawable/item_selected_background.xml
new file mode 100755
index 0000000..333b999
--- /dev/null
+++ b/filetree/src/main/res/drawable/item_selected_background.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+ <!-- 
+ ~ Copyright 2024 Zyron Official.
+ ~
+ ~ Licensed under the Apache License, Version 2.0 (the "License");
+ ~ you may not use this file except in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing, software
+ ~ distributed under the License is distributed on an "AS IS" BASIS,
+ ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ~ See the License for the specific language governing permissions and
+ ~ limitations under the License.
+ -->
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:top="0dp" android:bottom="0dp">
+        <shape android:shape="rectangle">
+            <solid android:color="@macro/m3_comp_navigation_drawer_active_indicator_color" />
+            <corners android:radius="50dp" />
+        </shape>
+    </item>
+</layer-list>
\ No newline at end of file
diff --git a/filetree/src/main/res/drawable/item_view_background.xml b/filetree/src/main/res/drawable/item_view_background.xml
new file mode 100755
index 0000000..94b6cee
--- /dev/null
+++ b/filetree/src/main/res/drawable/item_view_background.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+ <!-- 
+ ~ Copyright 2024 Zyron Official.
+ ~
+ ~ Licensed under the Apache License, Version 2.0 (the "License");
+ ~ you may not use this file except in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing, software
+ ~ distributed under the License is distributed on an "AS IS" BASIS,
+ ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ~ See the License for the specific language governing permissions and
+ ~ limitations under the License.
+ -->
+<ripple xmlns:android="http://schemas.android.com/apk/res/android" android:color="?attr/colorControlHighlight">
+    <item android:id="@android:id/mask" android:top="0dp" android:bottom="0dp">
+        <shape>
+            <solid android:color="?attr/colorControlActivated" />
+            <corners android:radius="50dp" />
+        </shape>
+    </item>
+    <item android:id="@+id/state">
+        <selector>
+            <item android:drawable="@drawable/item_selected_background" android:state_selected="true" />
+            <item android:drawable="@drawable/item_activated_background" android:state_activated="true" />
+        </selector>
+    </item>
+</ripple>
\ No newline at end of file
diff --git a/filetree/src/main/res/layout/filetree_view_item.xml b/filetree/src/main/res/layout/filetree_view_item.xml
new file mode 100755
index 0000000..05d240d
--- /dev/null
+++ b/filetree/src/main/res/layout/filetree_view_item.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+ <!-- 
+ ~ Copyright 2024 Zyron Official.
+ ~
+ ~ Licensed under the Apache License, Version 2.0 (the "License");
+ ~ you may not use this file except in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing, software
+ ~ distributed under the License is distributed on an "AS IS" BASIS,
+ ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ~ See the License for the specific language governing permissions and
+ ~ limitations under the License.
+ -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="53dp"
+    android:orientation="horizontal"
+    android:paddingHorizontal="16dp"
+    android:paddingVertical="4dp"
+	android:layout_marginLeft="48dp"
+	android:layout_marginRight="48dp"
+    android:gravity="center_vertical">
+
+    <ImageView
+        android:id="@+id/chevronIconView"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+		android:layout_marginLeft="10dp"
+	    android:layout_marginRight="5dp" />
+
+    <ImageView
+        android:id="@+id/fileIconView"
+        android:layout_width="24dp"
+        android:layout_height="24dp" 
+        android:padding="32dp"
+        android:scaleType="fitCenter"
+    	android:layout_marginRight="4dp"   />
+
+    <TextView
+        android:id="@+id/fileNameView"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textColor="?attr/colorSurfaceInverse"
+        android:textSize="17dp" 
+        android:layout_marginRight="16dp"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/filetree/src/main/res/values/attrs.xml b/filetree/src/main/res/values/attrs.xml
new file mode 100755
index 0000000..223fe47
--- /dev/null
+++ b/filetree/src/main/res/values/attrs.xml
@@ -0,0 +1,33 @@
+ <!-- 
+ ~ Copyright 2024 Zyron Official.
+ ~
+ ~ Licensed under the Apache License, Version 2.0 (the "License");
+ ~ you may not use this file except in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing, software
+ ~ distributed under the License is distributed on an "AS IS" BASIS,
+ ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ~ See the License for the specific language governing permissions and
+ ~ limitations under the License.
+ -->
+<resources>
+    <declare-styleable name="FileTreeView">
+        <attr name="recyclerItemViewCount" format="integer"/>
+        <attr name="recyclerItemViewEnabled" format="boolean"/>
+        <attr name="itemViewCacheSize" format="integer"/>
+        <attr name="itemViewCachingEnabled" format="boolean"/>
+        <attr name="fileMapMaxSize" format="integer"/>
+        <attr name="fileMapEnabled" format="boolean"/> 
+        <attr name="fileTreeAnimation" format="enum">
+            <enum name="FallDown" value="0"/>
+            <enum name="RotateIn" value="1"/>
+            <enum name="ScaleUp" value="2"/>
+            <enum name="SlideIn" value="3"/>
+            <enum name="Default" value="4"/>
+        </attr>
+        <attr name="fileTreeAnimationEnabled" format="boolean"/>
+    </declare-styleable>
+</resources>
\ No newline at end of file
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml
index e888bae..67341d3 100644
--- a/gradle/libs.versions.toml
+++ b/gradle/libs.versions.toml
@@ -1,4 +1,5 @@
 [versions]
+kotlin = "1.9.0"
 activity = "1.12.4"
 agp = "9.0.1"
 desugar_jdk_libs = "2.1.5"
@@ -15,6 +16,7 @@ navigationUi = "2.9.7"
 transition = "1.7.0"
 
 [libraries]
+kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }
 activity = { module = "androidx.activity:activity", version.ref = "activity" }
 desugar_jdk_libs = { module = "com.android.tools:desugar_jdk_libs", version.ref = "desugar_jdk_libs" }
 editor = { module = "io.github.rosemoe:editor" }
@@ -34,4 +36,5 @@ transition = { module = "androidx.transition:transition", version.ref = "transit
 
 [plugins]
 android-application = { id = "com.android.application", version.ref = "agp" }
+kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
 
diff --git a/settings.gradle.kts b/settings.gradle.kts
index 20d9b61..e14975d 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -21,3 +21,4 @@ dependencyResolutionManagement {
 
 rootProject.name = "Sparkles Editor"
 include(":app")
+include(":filetree")

From 5287a74a14b551dc1a23e06522fbd568e01092c6 Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:00:49 +0100
Subject: [PATCH 02/12] fix : minifying issue

---
 app/build.gradle.kts   | 2 +-
 app/proguard-rules.pro | 7 ++++++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 497df57..05da44e 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -33,7 +33,7 @@ android {
     }
     buildTypes {
         release{
-                isMinifyEnabled = false
+                isMinifyEnabled = true
                 isShrinkResources = false
                 proguardFiles(
                 getDefaultProguardFile("proguard-android-optimize.txt"),
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
index 481bb43..b863210 100644
--- a/app/proguard-rules.pro
+++ b/app/proguard-rules.pro
@@ -18,4 +18,9 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
\ No newline at end of file
+#-renamesourcefileattribute SourceFile
+
+# Keep all Fragment subclasses
+-keep public class * extends androidx.fragment.app.Fragment
+# Or more specifically:
+-keep class com.sparkleseditor.fragments.** { *; }
\ No newline at end of file

From abe9afdee75fa3bb30862d4766aaa15569be44bb Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:09:38 +0100
Subject: [PATCH 03/12] fix : files not added

---
 filetree/.gitignore                               |  0
 filetree/build.gradle                             | 15 ++++++++-------
 filetree/proguard-rules.pro                       |  0
 filetree/src/main/AndroidManifest.xml             |  0
 .../main/kotlin/com/zyron/filetree/FileTree.kt    |  0
 .../com/zyron/filetree/adapter/FileTreeAdapter.kt |  0
 .../filetree/callback/FileTreeDiffCallback.kt     |  0
 .../com/zyron/filetree/datamodel/FileTreeNode.kt  |  0
 .../filetree/events/FileTreeEventListener.kt      |  0
 .../com/zyron/filetree/map/ConcurrentFileMap.kt   |  0
 .../com/zyron/filetree/map/FileMapManager.kt      |  0
 .../filetree/provider/DefaultFileIconProvider.kt  |  0
 .../zyron/filetree/provider/FileIconProvider.kt   |  0
 .../main/kotlin/com/zyron/filetree/utils/Utils.kt |  0
 .../filetree/viewholder/FileTreeViewHolder.kt     |  0
 .../com/zyron/filetree/widget/FileTreeView.kt     |  0
 filetree/src/main/res/anim/default_anim.xml       |  0
 filetree/src/main/res/anim/default_animation.xml  |  0
 filetree/src/main/res/anim/fall_down.xml          |  0
 .../src/main/res/anim/fall_down_animation.xml     |  0
 filetree/src/main/res/anim/rotate_in.xml          |  0
 .../src/main/res/anim/rotate_in_animation.xml     |  0
 filetree/src/main/res/anim/scale_up.xml           |  0
 filetree/src/main/res/anim/scale_up_animation.xml |  0
 filetree/src/main/res/anim/slide_in.xml           |  0
 filetree/src/main/res/anim/slide_in_animation.xml |  0
 filetree/src/main/res/drawable/ic_chevron.xml     |  0
 filetree/src/main/res/drawable/ic_file.xml        |  0
 filetree/src/main/res/drawable/ic_folder.xml      |  0
 .../res/drawable/item_activated_background.xml    |  0
 .../res/drawable/item_selected_background.xml     |  0
 .../main/res/drawable/item_view_background.xml    |  0
 .../src/main/res/layout/filetree_view_item.xml    |  0
 filetree/src/main/res/values/attrs.xml            |  0
 34 files changed, 8 insertions(+), 7 deletions(-)
 mode change 100755 => 100644 filetree/.gitignore
 mode change 100755 => 100644 filetree/build.gradle
 mode change 100755 => 100644 filetree/proguard-rules.pro
 mode change 100755 => 100644 filetree/src/main/AndroidManifest.xml
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt
 mode change 100755 => 100644 filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt
 mode change 100755 => 100644 filetree/src/main/res/anim/default_anim.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/default_animation.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/fall_down.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/fall_down_animation.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/rotate_in.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/rotate_in_animation.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/scale_up.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/scale_up_animation.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/slide_in.xml
 mode change 100755 => 100644 filetree/src/main/res/anim/slide_in_animation.xml
 mode change 100755 => 100644 filetree/src/main/res/drawable/ic_chevron.xml
 mode change 100755 => 100644 filetree/src/main/res/drawable/ic_file.xml
 mode change 100755 => 100644 filetree/src/main/res/drawable/ic_folder.xml
 mode change 100755 => 100644 filetree/src/main/res/drawable/item_activated_background.xml
 mode change 100755 => 100644 filetree/src/main/res/drawable/item_selected_background.xml
 mode change 100755 => 100644 filetree/src/main/res/drawable/item_view_background.xml
 mode change 100755 => 100644 filetree/src/main/res/layout/filetree_view_item.xml
 mode change 100755 => 100644 filetree/src/main/res/values/attrs.xml

diff --git a/filetree/.gitignore b/filetree/.gitignore
old mode 100755
new mode 100644
diff --git a/filetree/build.gradle b/filetree/build.gradle
old mode 100755
new mode 100644
index 23135b2..125a264
--- a/filetree/build.gradle
+++ b/filetree/build.gradle
@@ -1,14 +1,15 @@
 plugins {
     id 'com.android.library'
+    id 'org.jetbrains.kotlin.android' 
 }
 
 android {
     namespace 'com.zyron.filetree'
-    compileSdk 34
+    compileSdk 36
 
     defaultConfig {
         minSdk 21
-        targetSdk 34
+        targetSdk 36
 
         vectorDrawables {
             useSupportLibrary true
@@ -34,10 +35,10 @@ android {
 }
 
 dependencies {
-    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
-    implementation 'com.google.android.material:material:1.12.0'
-    implementation 'androidx.appcompat:appcompat:1.7.0'
-    implementation 'androidx.core:core-ktx:1.13.1'  
-    implementation 'androidx.recyclerview:recyclerview:1.3.2'
+    implementation 'androidx.constraintlayout:constraintlayout:2.2.1'
+    implementation 'com.google.android.material:material:1.13.0'
+    implementation 'androidx.appcompat:appcompat:1.7.1'
+    implementation 'androidx.core:core-ktx:1.17.0'
+    implementation 'androidx.recyclerview:recyclerview:1.4.0'
     implementation 'androidx.preference:preference-ktx:1.2.1'
 }
\ No newline at end of file
diff --git a/filetree/proguard-rules.pro b/filetree/proguard-rules.pro
old mode 100755
new mode 100644
diff --git a/filetree/src/main/AndroidManifest.xml b/filetree/src/main/AndroidManifest.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt b/filetree/src/main/kotlin/com/zyron/filetree/FileTree.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt b/filetree/src/main/kotlin/com/zyron/filetree/adapter/FileTreeAdapter.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt b/filetree/src/main/kotlin/com/zyron/filetree/callback/FileTreeDiffCallback.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt b/filetree/src/main/kotlin/com/zyron/filetree/datamodel/FileTreeNode.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt b/filetree/src/main/kotlin/com/zyron/filetree/events/FileTreeEventListener.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt b/filetree/src/main/kotlin/com/zyron/filetree/map/ConcurrentFileMap.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt b/filetree/src/main/kotlin/com/zyron/filetree/map/FileMapManager.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt b/filetree/src/main/kotlin/com/zyron/filetree/provider/DefaultFileIconProvider.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt b/filetree/src/main/kotlin/com/zyron/filetree/provider/FileIconProvider.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt b/filetree/src/main/kotlin/com/zyron/filetree/utils/Utils.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt b/filetree/src/main/kotlin/com/zyron/filetree/viewholder/FileTreeViewHolder.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt b/filetree/src/main/kotlin/com/zyron/filetree/widget/FileTreeView.kt
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/default_anim.xml b/filetree/src/main/res/anim/default_anim.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/default_animation.xml b/filetree/src/main/res/anim/default_animation.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/fall_down.xml b/filetree/src/main/res/anim/fall_down.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/fall_down_animation.xml b/filetree/src/main/res/anim/fall_down_animation.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/rotate_in.xml b/filetree/src/main/res/anim/rotate_in.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/rotate_in_animation.xml b/filetree/src/main/res/anim/rotate_in_animation.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/scale_up.xml b/filetree/src/main/res/anim/scale_up.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/scale_up_animation.xml b/filetree/src/main/res/anim/scale_up_animation.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/slide_in.xml b/filetree/src/main/res/anim/slide_in.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/anim/slide_in_animation.xml b/filetree/src/main/res/anim/slide_in_animation.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/drawable/ic_chevron.xml b/filetree/src/main/res/drawable/ic_chevron.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/drawable/ic_file.xml b/filetree/src/main/res/drawable/ic_file.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/drawable/ic_folder.xml b/filetree/src/main/res/drawable/ic_folder.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/drawable/item_activated_background.xml b/filetree/src/main/res/drawable/item_activated_background.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/drawable/item_selected_background.xml b/filetree/src/main/res/drawable/item_selected_background.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/drawable/item_view_background.xml b/filetree/src/main/res/drawable/item_view_background.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/layout/filetree_view_item.xml b/filetree/src/main/res/layout/filetree_view_item.xml
old mode 100755
new mode 100644
diff --git a/filetree/src/main/res/values/attrs.xml b/filetree/src/main/res/values/attrs.xml
old mode 100755
new mode 100644

From 84f7a4f6d9f259776ea6149dd9fcd87ffc03d998 Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:13:50 +0100
Subject: [PATCH 04/12] fix : filetree library issues

---
 filetree/build.gradle | 1 -
 1 file changed, 1 deletion(-)

diff --git a/filetree/build.gradle b/filetree/build.gradle
index 125a264..b107dab 100644
--- a/filetree/build.gradle
+++ b/filetree/build.gradle
@@ -1,6 +1,5 @@
 plugins {
     id 'com.android.library'
-    id 'org.jetbrains.kotlin.android' 
 }
 
 android {

From d23b30c8cf8a9f87a44dd2ce76bba8f0d6d83561 Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:23:47 +0100
Subject: [PATCH 05/12] fix : filetree library issues

---
 app/proguard-rules.pro | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
index b863210..4e7e4ba 100644
--- a/app/proguard-rules.pro
+++ b/app/proguard-rules.pro
@@ -20,7 +20,7 @@
 # hide the original source file name.
 #-renamesourcefileattribute SourceFile
 
-# Keep all Fragment subclasses
 -keep public class * extends androidx.fragment.app.Fragment
-# Or more specifically:
--keep class com.sparkleseditor.fragments.** { *; }
\ No newline at end of file
+-keep class com.sparkleseditor.fragments.** { *; }
+-keep class com.zyron.filetree.** { *; }
+-dontwarn com.zyron.filetree.**
\ No newline at end of file

From 1833a22e2b04ed3d2de2b4b9b1f51ce332f7cbeb Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:44:50 +0100
Subject: [PATCH 06/12] fix : proguard-rules.pro removed

---
 app/build.gradle.kts   | 4 ----
 app/proguard-rules.pro | 8 ++++----
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 05da44e..6fd8d15 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -35,10 +35,6 @@ android {
         release{
                 isMinifyEnabled = true
                 isShrinkResources = false
-                proguardFiles(
-                getDefaultProguardFile("proguard-android-optimize.txt"),
-                "proguard-rules.pro"
-            )
             signingConfig = signingConfigs.getByName("release")
         }
     }
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
index 4e7e4ba..a3dbedb 100644
--- a/app/proguard-rules.pro
+++ b/app/proguard-rules.pro
@@ -20,7 +20,7 @@
 # hide the original source file name.
 #-renamesourcefileattribute SourceFile
 
--keep public class * extends androidx.fragment.app.Fragment
--keep class com.sparkleseditor.fragments.** { *; }
--keep class com.zyron.filetree.** { *; }
--dontwarn com.zyron.filetree.**
\ No newline at end of file
+#-keep public class * extends androidx.fragment.app.Fragment
+#-keep class com.sparkleseditor.fragments.** { *; }
+#-keep class com.zyron.filetree.** { *; }
+#-dontwarn com.zyron.filetree.**
\ No newline at end of file

From e19f5a08a6a54520b365b3f5d06d5aade925f08f Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 20:00:57 +0100
Subject: [PATCH 07/12] fix : proguard-rules.pro removed

---
 app/build.gradle.kts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 6fd8d15..2eb1322 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -36,6 +36,7 @@ android {
                 isMinifyEnabled = true
                 isShrinkResources = false
             signingConfig = signingConfigs.getByName("release")
+            //ProguardsRemoved Temporary
         }
     }
     compileOptions {

From eddedc6e6f722b7f46a3872cc13265f51d693afa Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 20:14:54 +0100
Subject: [PATCH 08/12] fix : proguard-rules.pro returned

---
 app/build.gradle.kts   | 4 ++--
 app/proguard-rules.pro | 9 +++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 2eb1322..d8784e7 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -35,8 +35,8 @@ android {
         release{
                 isMinifyEnabled = true
                 isShrinkResources = false
-            signingConfig = signingConfigs.getByName("release")
-            //ProguardsRemoved Temporary
+                signingConfig = signingConfigs.getByName("release")
+                proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
         }
     }
     compileOptions {
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
index a3dbedb..bc00987 100644
--- a/app/proguard-rules.pro
+++ b/app/proguard-rules.pro
@@ -20,7 +20,8 @@
 # hide the original source file name.
 #-renamesourcefileattribute SourceFile
 
-#-keep public class * extends androidx.fragment.app.Fragment
-#-keep class com.sparkleseditor.fragments.** { *; }
-#-keep class com.zyron.filetree.** { *; }
-#-dontwarn com.zyron.filetree.**
\ No newline at end of file
+-keep public class * extends com.sparkleseditor.fragments.BaseFragment
+-keep class com.sparkleseditor.fragments.** { *; }
+-keep class com.zyron.filetree.** { *; }
+-dontwarn com.zyron.filetree.**
+-keep class com.sparkleseditor.MainActivity { *; }

From 195960311d26213410d13aba2a235ef89503137d Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 20:14:54 +0100
Subject: [PATCH 09/12] fix : proguard-rules.pro returned

---
 app/build.gradle.kts   | 4 ++--
 app/proguard-rules.pro | 9 +++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 2eb1322..d8784e7 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -35,8 +35,8 @@ android {
         release{
                 isMinifyEnabled = true
                 isShrinkResources = false
-            signingConfig = signingConfigs.getByName("release")
-            //ProguardsRemoved Temporary
+                signingConfig = signingConfigs.getByName("release")
+                proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
         }
     }
     compileOptions {
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
index a3dbedb..bc00987 100644
--- a/app/proguard-rules.pro
+++ b/app/proguard-rules.pro
@@ -20,7 +20,8 @@
 # hide the original source file name.
 #-renamesourcefileattribute SourceFile
 
-#-keep public class * extends androidx.fragment.app.Fragment
-#-keep class com.sparkleseditor.fragments.** { *; }
-#-keep class com.zyron.filetree.** { *; }
-#-dontwarn com.zyron.filetree.**
\ No newline at end of file
+-keep public class * extends com.sparkleseditor.fragments.BaseFragment
+-keep class com.sparkleseditor.fragments.** { *; }
+-keep class com.zyron.filetree.** { *; }
+-dontwarn com.zyron.filetree.**
+-keep class com.sparkleseditor.MainActivity { *; }

From 5912c9cf3bd71b22ce7dc237d9abc31fc6ee9ce5 Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 20:19:16 +0100
Subject: [PATCH 10/12] fix : proguard-rules.pro returned

---
 app/build.gradle.kts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index d8784e7..da0390e 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -36,7 +36,7 @@ android {
                 isMinifyEnabled = true
                 isShrinkResources = false
                 signingConfig = signingConfigs.getByName("release")
-                proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
+                proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro") //returning for now
         }
     }
     compileOptions {

From 13af3410ff166b5356f1c37b2e47e2bae1c0b2db Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Thu, 19 Feb 2026 20:32:41 +0100
Subject: [PATCH 11/12] fix : proguard-rules.pro patches

---
 app/build.gradle.kts  | 2 +-
 filetree/build.gradle | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index da0390e..d89ad3c 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -33,7 +33,7 @@ android {
     }
     buildTypes {
         release{
-                isMinifyEnabled = true
+                isMinifyEnabled = false
                 isShrinkResources = false
                 signingConfig = signingConfigs.getByName("release")
                 proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro") //returning for now
diff --git a/filetree/build.gradle b/filetree/build.gradle
index b107dab..edcc991 100644
--- a/filetree/build.gradle
+++ b/filetree/build.gradle
@@ -17,7 +17,7 @@ android {
 
     buildTypes {
         release {
-            minifyEnabled true
+            minifyEnabled false
             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }

From 6b50a352f0aef05c1ab8a8c081c5ec7ddae70859 Mon Sep 17 00:00:00 2001
From: SyntaxSpin <86142168+SyntaxSpin@users.noreply.github.com>
Date: Sat, 21 Feb 2026 06:47:19 +0100
Subject: [PATCH 12/12] feat : MinorUi improvements

---
 app/src/main/res/layout/fragment_main.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app/src/main/res/layout/fragment_main.xml b/app/src/main/res/layout/fragment_main.xml
index 2b1af4d..cab4aa3 100644
--- a/app/src/main/res/layout/fragment_main.xml
+++ b/app/src/main/res/layout/fragment_main.xml
@@ -184,6 +184,7 @@
                 android:layout_height="match_parent"
                 android:layout_width="match_parent"
                 android:orientation="vertical"
+                android:layout_weight="1"
                 android:id="@+id/container">
 
                 <LinearLayout
@@ -212,6 +213,7 @@
                         android:layout_width="match_parent"
                         android:layout_height="match_parent"
                         android:gravity="center"
+                        android:layout_weight="1"
                         android:id="@+id/require_folder"
                         android:orientation="vertical">
                         <TextView