Android app · Productivity

FolderFlow

File and folder organization utility for tidier local storage workflows.

Get it on Google Play ↗ Source on GitHub ↗

Project Overview

FolderFlow is an Android app for turning a crowded app drawer into smart, reviewable groups. It scans installed launcher apps, classifies them into Play Store-style categories, lets users add custom tags, and highlights apps that have been idle for a chosen threshold.

The project is aimed at Android users who want local-first app organization and lightweight cleanup without account setup.

Key Features

• 📁 Smart folders group apps by category, custom tags, recent installs, or unused-app rules.
• 🔎 App Index provides a searchable view of installed launcher apps with category and sorting tools.
• 🏷️ Color-coded tags let users create personal groupings across categories.
• 💤 Idle Scanner surfaces apps that have not been opened past a selected threshold.
• 🧩 Home-screen widget support exposes folder content outside the main app.
• 🛡️ Local Room storage keeps folder rules, category overrides, and tags on the device.
• 🖼️ Roborazzi tests generate Play Store screenshots, app icon, and feature graphics.

Architecture Overview

The app follows a small clean-architecture shape: Compose screens own rendering, ViewModels expose screen state, domain use cases express actions, repository interfaces hide storage details, and Room persists app metadata, folders, rules, tags, and app-tag relationships. Package scans flow from Android PackageManager into AppRepositoryImpl, usage data is optionally read from UsageStatsManager, and folder membership is derived from rule matching rather than duplicated data.

Tech Stack & Libraries

Configuration

Primary configuration lives in these files:

Release signing is configured in Gradle, but release credentials should be provided locally through environment variables or key.properties; do not commit private signing material.

Usage / Quick Start

Build and run the debug app:

./gradlew :app:assembleDebug
./gradlew :app:installDebug

Generate Play Store assets from the screenshot tests:

./gradlew generatePlayStoreAssets

Preview the privacy policy site from the sibling workspace, if present:

cd ../FolderFlow-pv
python3 -m http.server 8080 --directory .

API Reference

Not applicable. FolderFlow is a local Android app and does not expose an HTTP API, CLI API, or public SDK. Retrofit and OkHttp are present as dependencies, but the inspected source does not define network service endpoints.

Testing

Run the standard JVM test suite:

./gradlew :app:testDebugUnitTest

Run connected Android tests on an emulator or device:

./gradlew :app:connectedDebugAndroidTest

Run screenshot recording for Play Store assets:

./gradlew generatePlayStoreAssets

Tests live under app/src/test/java/com/michael/folderflow/ and app/src/androidTest/java/com/michael/folderflow/. Current naming uses *Test.kt for unit, Robolectric, ViewModel, DAO, domain, Compose interaction, and screenshot tests. No coverage-report task is configured in the inspected Gradle files.

Deployment

Android release builds are produced with Gradle:

./gradlew :app:bundleRelease

The repository does not include Docker or docker-compose deployment. Release distribution is expected to happen through

in the sibling FolderFlow-pv/ project and can be deployed to Netlify with publish directory . and no build command.

Health checks are not applicable for the Android app. For the privacy-policy site, verify that the deployed Netlify URL returns the static index.html and that Google Play Console references that URL.