Skip to content

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

23 Commits

Folders and files

Repository files navigation

TaskFlow logo — blue, cyan and purple ribbons forming a checkmark

مهامي · Mahami

Organize your day. Move your projects forward.

نظّم يومك وأنجز مهامك — مهامك ومشاريعك في مكان واحد.

Native iOS & Android apps · Arabic-first · Local storage

Native iOS with SwiftUI Native Android with Jetpack Compose Arabic interface with right-to-left layouts In development

See the app ↓   ·   Explore the stack   ·   Run locally   ·   More projects ↗

Mahami is an Arabic task and project manager built around a simple daily flow: capture a task, give it a priority and a date, organize it under a project, and follow your progress. Purple accents, clear Arabic typography and project colors connect the experience across both platforms.

Two native implementations: iOS is written in Swift with SwiftUI, and Android in Kotlin with Jetpack Compose. Each platform has its own UI, state management and local persistence, with shared product rules.

Screenshots

Actual Android app captures supplied by the project owner on October 8, 2026, using fictional presentation data. These show the Android experience; iOS has a separate native implementation.

Arabic welcome screen with a purple checklist and calendar illustration
A clear beginning
Arabic welcome and productivity illustration
Home screen with 43 percent daily progress, active projects and today's tasks
Your day at a glance
Daily progress, active projects and tasks
Arabic task list with search, date selection, status filters and pinned tasks
Focus on the next task
Search, dates, status filters and pinned priorities
Four projects with colored icons, completion percentages and open task counts
Give every project a place
Project identities, task counts and progress
See task details and creation screens — 4 more captures
Pinned task detail sheet showing formatted description, priority, dates and edit action
The context behind the task
Formatted notes, priority, dates and status
Open task detail sheet for preparing Arabic presentation screenshots
Keep the details close
Project context and editable task information
Native task creation sheet with title, description, status, pin and priority controls
Capture a new task
Title, notes, status, pinning and priority
Native project creation sheet with name, emoji, color choices and save action
Make a project recognizable
A name, an icon and a color

Open the original screenshots and capture notes.

Features

Flow Experience
Plan the day Daily progress, today's tasks and an overdue indicator
Capture a task Quick add or a full editor with a title, notes, priority, date and optional project
Follow through Open, in progress and completed states; complete or reopen a task
Find the right work Title search and filters for date, status, priority and project
Keep priorities visible Pinned tasks and three priority levels
Organize projects Project names, emoji, colors, open task counts and completion progress
Look ahead A monthly calendar with task counts and day-to-task navigation
Keep useful context Task details with lightweight Markdown formatting
Keep your work Persistent local storage; deleting a project keeps its tasks
Remember the time Optional local task reminders, updated or cancelled with the task
Carry work between devices Optional email account and manual personal cloud sync with a backup before first sync
Read comfortably Arabic RTL layouts, Cairo/Lexend typography and system light/dark themes

Native on both platforms

iOS Android
Language Swift Kotlin
Interface SwiftUI Jetpack Compose / Material 3
Local persistence SwiftData Room
State Observation / screen models ViewModel / StateFlow
Concurrency Swift concurrency Kotlin coroutines / Flow
Minimum OS iOS 17 Android 8.0 · API 26
Source ios/TaskManagement android/app/src/main

Both applications separate presentation, domain contracts and data implementations. Task dates, completion, project deletion and sorting follow the same documented data rules.

Project status

An actively developed portfolio project. The current Android presentation build has been built, installed and opened on a physical Android 15 device. Its demo import added four projects and sixteen tasks; a second import added zero duplicates.

Area Current state
Core local experience Implemented in both native codebases; the supplied captures are from Android
Android verification Debug build/lint, installation, launch and demo import verified; reminder and cloud verification details are tracked in the project state
iOS verification Simulator build and startup to the existing Home verified; physical-device and cloud acceptance remain pending
Reminders Native implementations on both platforms; Android delivery and task-opening checks are recorded in the verification notes
Cloud sync Both clients use the deployed owner-only, atomic sync RPC; stale writes, deletion, date-only transport and isolation verified in rollback fixtures; real-account two-device acceptance pending
Store release No App Store or Google Play release is linked in this showcase

The screenshots use fictional presentation content. Demo import is explicit in the Android debug build; normal launches preserve existing data without inserting samples. See current project state for the detailed verification record.

For developers: local setup and repository map

Run locally

git clone https://github.com/Husseinabozina/task_management_native.git
cd task_management_native

iOS

On a Mac with Xcode supporting the iOS 17 deployment target:

  1. Open ios/TaskManagement.xcodeproj.
  2. Select the TaskManagement scheme and an iPhone or simulator.
  3. Let Xcode resolve the package dependencies, then run.

The generated Xcode project is included. ios/project.yml is the XcodeGen source if you need to regenerate it. Local tasks use SwiftData; optional cloud configuration is separate from the local presentation flow.

Android

Open the android folder in Android Studio, configure Android SDK 36 and a compatible Gradle JDK, then select a device and run. The checked-in wrapper is Gradle 8.14.3; the recorded local build used JDK 24.0.2. The source targets Java/JVM 17.

To build and lint from the repository root, with your SDK configured:

./android/gradlew -p android :app:assembleDebug :app:lintDebug \
  -Pkotlin.compiler.execution.strategy=in-process

APK output: android/app/build/outputs/apk/debug/app-debug.apk.

On macOS, android/run-on-device.command builds, installs with existing data retained, and opens the app on one connected, USB-debugging-authorized phone. Set the SDK and cache paths for your machine:

export ANDROID_HOME="/path/to/Android/sdk"
export GRADLE_USER_HOME="$HOME/.gradle"
./android/run-on-device.command

# Explicitly add the fictional presentation content to a debug build.
./android/run-on-device.command --seed-demo

The script also accepts --serial DEVICE_ID when multiple phones are connected. It reads sdk.dir and the optional taskmanagement.gradleUserHome from ignored android/local.properties; environment variables take precedence. Demo identifiers are stable: repeat imports preserve existing rows and respect deleted samples. Once installed, open مهامي from the phone's launcher without a computer or cable.

Optional personal cloud sync

Local tasks work without an account. To enable email/password accounts and manual sync in your build, follow the cloud setup guide. Real client configuration stays outside Git; each platform includes a configuration example. The first sync saves a local backup and binds the local data set to that account.

See Security and local configuration before adding keys, signing files or app data to a checkout.

Repository map

ios/                 SwiftUI app, domain, SwiftData and platform services
android/             Compose app, domain, Room and device launcher
assets/figma/        Original design references, icons and shapes
docs/showcase/       README media and capture provenance
docs/product/        Scope and user flows
docs/architecture/   Architecture, data contracts and decisions
docs/project/        Verified state, acceptance checklist and backlog

Architecture · Data contracts · Acceptance checklist

More by Hussein Abozina

Project Explore
NOVA — fashion shopping experience View the portfolio ↗
Brees — fintech mobile experience View the portfolio ↗
HealthTrack — healthcare UI portfolio View the portfolio ↗

Hussein Abozina · GitHub profile · Project repository

Design foundation: Task management & to-do list app — Figma Community. Arabic copy and the current productivity illustration were adapted for Mahami. Media provenance.

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages