NexaFlow

KO | EN

gitlite — search

#proxy #generative-ai #devops #shell #openai #nlp #rust #csharp #golang #redis

(★ 9)

Advanced Context-Aware Automation Engine for Android

File Explorer

ZIP Download

- - android-ci.yml
  - release-after-ci.yml
- dependabot.yml
- build.gradle.kts
- consumer-rules.pro
- proguard-rules.pro
- build.gradle.kts
- consumer-rules.pro
- build.gradle.kts
- settings.gradle.kts
- - detekt.yml
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
  - proguard-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
  - proguard-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
  - proguard-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
  - proguard-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
  - privapp-permissions-nexaflow.xml
- - build.gradle.kts
  - consumer-rules.pro
  - proguard-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- build.gradle.kts
- consumer-rules.pro
- - architecture-current.md
  - architecture-migration.md
  - architecture-target.md
  - ecosystem-completion-baseline.md
  - ecosystem-contract-design.md
  - plugin-capability-expansion-baseline.md
  - plugin-compatibility-contract.md
  - workflow-flow-control-status.md
- - CURRENT_ARCHITECTURE_2026.md
  - FORENSIC_INVENTORY_2026.txt
  - GAP_ANALYSIS_2026.json
  - GAP_ANALYSIS_2026.md
  - production-readiness-baseline-ar.md
- - phase-0-architecture-freeze.md
  - phase-1-event-architecture.md
  - phase-10-import-export-plugin-dependencies.md
  - phase-11-plugin-observability.md
  - phase-12-quality-matrix.md
  - phase-2-data-runtime.md
  - phase-3-task-manager-hardening.md
  - phase-4-durable-execution.md
  - phase-5-capability-validation.md
  - phase-6-plugin-discovery-compatibility.md
  - phase-6-security-plugins-workflow-versioning.md
  - phase-7-plugin-capability-action-bridge.md
  - phase-7-validation-dryrun-import.md
  - phase-8-native-capability-catalog.md
  - phase-8-runtime-capability-wiring.md
  - phase-9-workflow-data-hardening.md
  - v3.33.0-ecosystem-completion-report.md
  - v3.41.4-benchmark-remediation-report-ar.md
- - action-expansion-roadmap.md
  - android-automation-expansion-evidence.md
  - android-maintenance-execution-official-evidence.md
  - android-production-runtime-official-evidence-v3370.md
  - android-shizuku-managed-capability-evidence-v3371.md
  - ecosystem-public-interfaces.md
  - google-play-update-capability-matrix.md
  - google-play-update-engine-repository-audit.md
  - plugin-protocol-public-sources.md
  - production-maintenance-runtime-minimal-design.md
  - production-maintenance-runtime-repository-audit.md
  - v3.37.0-minimal-runtime-expansion-design.md
  - v3.37.0-production-runtime-audit.md
  - v3.37.1-capability-driven-ui-minimal-design.md
  - v3.37.1-capability-driven-ui-repository-audit.md
  - v3.38.0-capability-driven-ui-final-report.md
- - android-connected-test-protocol.md
  - android-real-execution-validation-final-report.md
  - android-real-execution-validation-matrix.md
  - android-validation-environment.md
  - google-play-update-engine-validation.md
- - samsung-like-options-simplification-plan-ar.md
- android17_automation_audit_research.md
- android17_device_acceptance.md
- android17_hotspot_scheduler_research.md
- ARCHITECTURE.md
- AUTOMATION_ENGINE_AUDIT_2026.md
- AUTOMATION_IPAAS_ARCHITECTURE.md
- automation_quality_audit_ar.md
- capability-execution-architecture-audit.md
- capability-execution-contracts.md
- dns-platform-findings.md
- ENTERPRISE_ARCHITECTURE_REPORT.md
- fix_report_ar.md
- FIXED_LOCATION_TRIGGER.md
- GOOGLE_2026_DESIGN.md
- IMPROVEMENT_PLAN.md
- NETWORK_MODE_RESEARCH_2026.md
- options-audit.md
- PLUGIN_SDK.md
- production-runtime-architecture-audit.md
- production-runtime-contracts.md
- PRODUCTION_AUDIT.md
- REQUIRED_CHECKS.md
- RESEARCH_2026.md
- ROADMAP_2026.md
- ROM_DETECTION_MATRIX.md
- STRICT_TASK_LIFECYCLE.md
- UI_UX_AUDIT_2026.md
- V3.50.2_RESEARCH.md
- build.gradle.kts
- consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - build.gradle.kts
  - consumer-rules.pro
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- verification-metadata.xml
- foojay-trust-sealed.gradle
- keystore.properties.example
- README.md
- build.gradle.kts
- - privapp-permissions-com.nexaflow.app.xml
- - nexaflow.te
- Android.bp
- install-rom-integration.ps1
- install-rom-integration.sh
- NexaFlow.mk
- privapp-permissions-com.nexaflow.app.xml
- README.md
- - build.gradle.kts
  - proguard-rules.pro
- README.md
- - app_strings.json
  - automation-builder_strings.json
  - automations_strings.json
  - capability-manager_strings.json
  - icons_strings.json
  - settings_strings.json
  - themes_strings.json
- - test_auto_fix.py
  - test_check_lint_config.py
  - test_check_resources.py
  - test_check_resources_pytest.py
- add_backup_result_strings.py
- add_calendar_strings.py
- add_charger_strings.py
- add_evolution_strings.py
- add_exit_reply_string.py
- add_exit_strings.py
- add_feature_strings.py
- add_history_paging_strings.py
- add_java21_toolchain.py
- add_location_strings.py
- add_network_strings.py
- add_notification_strings.py
- add_permission_denied.py
- add_permission_explain_strings.py
- add_repeat_selected.py
- add_reply_strings.py
- add_rom_setting_labels.py
- add_rom_setting_strings.py
- add_save_locally_label.py
- add_sensor_strings.py
- add_special_permission_strings.py
- add_strings.py
- add_task_card_title.py
- add_tiles_location_strings.py
- add_tiles_strings.py
- add_update_dialog_strings.py
- add_update_strings.py
- add_ux_strings.py
- audit_catalog_and_releases.py
- audit_trigger_catalog.py
- auto_fix.py
- check_16kb.py
- check_apk_libs.py
- check_apk_phone_permission.py
- check_kotlin_balance.py
- check_resources.py
- check_strings_parity.py
- check_verification_metadata.py
- diff_action_keys.py
- diff_config_keys.py
- diff_trigger_keys.py
- escape_apostrophes.py
- fix_apostrophes_oneshot.py
- fix_catalog_accessors.py
- fix_fr_apostrophes.py
- fix_fr_calendar_apostrophes.py
- fix_fr_quotes.py
- fix_launcher_icon.sh
- generate_options_audit.py
- generate_release_notes.py
- i18n_add_call_sms_strings.py
- i18n_dashboard_call_sms.py
- i18n_manual_gate_messages.py
- i18n_propagate_call_sms.py
- i18n_translate_fallbacks.py
- i18n_trigger_split_strings.py
- i18n_v361_map_rom_strings.py
- i18n_v3621_picker_preview_strings.py
- i18n_v362_options_strings.py
- i18n_v363_evolver_picker.py
- i18n_v363_strings.py
- i18n_v364_strings.py
- migrate_version_catalog.py
- pixel_sample.py
- remove_strings.py
- rename_colliding_strings.py
- setup-signing.sh
- unify_terminology.py
- - build.gradle.kts
  - proguard-rules.pro
  - README.md
.gitattributes
.gitignore
build.gradle.kts
BUILD_TOOLCHAIN_HINTS.md
CHANGELOG.md
consumer-rules.pro
CONTRIBUTING.md
gradle.properties
gradlew
gradlew.bat
LICENSE
lint.xml
README.md
release_notes.md
SECURITY.md
settings.gradle.kts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Advanced Context-Aware Automation Engine for Android** — Samsung Modes & Routines style.

NexaFlow is a professional automation platform inspired by Samsung Modes & Routines and Tasker,
designed to provide a more powerful, customizable, and extensible automation experience.

## Features

- **Context-Aware Automations:** Create intelligent device automations using WHEN → THEN logic
  with 15 trigger types (time, battery, app, device event, connectivity, location, SMS,
  Bluetooth device, ringer mode) and 53 system actions (sound, display, connectivity, media,
  notifications, apps, battery, advanced).
- **Time triggers with full scheduling:** single time, time range (incl. overnight 22:00→06:00),
  repeat options (once / daily / weekdays / weekends / specific days / monthly / specific date /
  date range), and an end-of-range alarm that fires exit/revert behavior automatically.
- **Exit behavior:** per-task "when this ends" section with either a revert-to-original-state
  switch or custom exit actions (mutually exclusive).
- **Two-way editing:** tasks are fully editable — the builder loads an existing automation and
  pre-fills name, icon, triggers, actions and exit behavior.
- **Searchable multi-select pickers:** add several triggers/actions at once from a searchable
  dialog; reorder actions with arrows.
- **Safe data migrations:** every schema change ships an explicit Room `Migration` (1→5) with
  exported schemas — upgrades never wipe user data.
- **Modular Architecture:** clean multi-module structure (core/domain/data/feature/app).
- **Modern UI:** Jetpack Compose + Material 3 in a Samsung One UI style, 10-language i18n,
  Compose design previews for screens and components.
- **Background reliability:** `specialUse` foreground service, `setExactAndAllowWhileIdle`
  scheduling with `SCHEDULE_EXACT_ALARM`, battery-optimization exemption request.
- **Monitoring & controls:** home-screen toggle/status widgets, run-now button, live "next run"
  preview, execution history.
- **Themes:** accent colors + dark mode persisted via DataStore.
- **Capabilities:** permission manager, Shizuku/Root integration via `rom-integration`.

## Technology Stack

- **Language:** Kotlin 2.4.x
- **UI:** Jetpack Compose + Material 3 (Samsung-style)
- **Architecture:** Clean Architecture, MVVM, Repository Pattern
- **Dependency Injection:** Hilt
- **Database:** Room (with exported schemas + explicit migrations)
- **Storage:** DataStore
- **Asynchronous:** Kotlin Coroutines + Flow
- **Background:** Foreground Services, AlarmManager (`setExactAndAllowWhileIdle`)
- **Navigation:** Navigation Compose
- **Minimum SDK:** Android 8.0 (API 26)

## Project Structure

```
.github/workflows/       CI: lint gate, unit tests, debug+release build, auto-release on tags
app/                     Application module (theme, DI, navigation)
core/
  database/              Room DB + entities + explicit migrations + schema exports
  datastore/             Theme & notification preferences (DataStore)
  automation-engine/     MonitoringService, scheduler, monitors, alarm receiver
  execution/             ExecutionEngine that runs triggers/actions
  capability-manager/    Permission/capability center
  rom-integration/       Shizuku / Root integrations
  ui-components/         Shared Samsung-style components (cards, rows, pills…)
domain/                  Pure models, scheduling logic (TimeTriggerCalculator), use cases
data/                    Repository implementation + mappers
feature/
  dashboard/             Home screen with routine cards + search + run now
  automation-builder/    Single-page task editor (name, triggers, actions, exit behavior)
  automations/           Task details screen
  history/               Execution history
  icons/ themes/ widgets/ settings/
```

## Getting Started

1. Clone the repository:
   ```bash
   git clone https://github.com/Alaa91H/NexaFlow.git
   ```
2. Open the project in Android Studio (recent version with AGP 9.x / JDK 17).
3. Build and run on an Android 10+ device or emulator.

### Build commands

```bash
# Unit tests (includes Room migration tests + scheduler tests)
./gradlew testDebugUnitTest

# Assemble both variants
./gradlew assembleDebug assembleRelease

# Android Lint (quality gate)
./gradlew lintDebug

# Full local verification used before every release
./gradlew testDebugUnitTest assembleDebug assembleRelease
```

## Releasing

Releases are fully automated via Git tags. Pushing a `v*` tag to `main` triggers GitHub Actions
which builds, runs tests/lint and creates a GitHub Release with the release APK attached.

```bash
git tag v3.2.0-alpha
git push origin v3.2.0-alpha
```

Pre-release tags (`alpha` / `beta` / `rc`) are published as pre-releases automatically.

## Documentation

- [`docs/ROADMAP_2026.md`](docs/ROADMAP_2026.md) — the master fix/develop/optimize
  plan: workstreams, catalog policy, capability metadata design, device-matrix
  policy, and the release operating manual.
- [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — module map and the
  Trigger → Scheduler → Engine → Execution → History data flow.
- [`docs/REQUIRED_CHECKS.md`](docs/REQUIRED_CHECKS.md) — every CI quality gate and
  the branch-protection setup that enforces them.
- [`docs/PLUGIN_SDK.md`](docs/PLUGIN_SDK.md) — the Locale plugin protocol (EDIT_SETTING /
  FIRE_SETTING + Bundle JSON + Blurb) and the experimental `core/plugin-sdk` blueprint for
  third-party plugin developers.

## Contributing

We welcome contributions! Please see `CONTRIBUTING.md` for details.

## License

This project is licensed under the MIT License — see the `LICENSE` file for details.

NexaFlow

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README