bench get-app https://github.com/amrpyt/frappe-arabic

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=amrpyt%2Ffrappe-arabic)](https://frappegems.com/gems/apps/amrpyt/frappe-arabic)

Frappe Arabic

Human-reviewed Arabic translations and focused RTL hardening for Frappe Framework and ERPNext v16.

This app packages the reviewed Arabic layer developed during a full translation audit, then reapplies it safely after every migration without modifying Frappe or ERPNext core files.

Features

• 6,591 reviewed global translations.
• 23 context-sensitive translations.
• Preserves placeholders such as {0}, {name}, %s, and Jinja expressions.
• Preserves user-created Translation overrides.
• Reapplies managed translations after bench migrate.
• Generic RTL fixes for mixed Arabic/Latin values, email addresses, URLs, phone numbers, barcodes, and identifiers.
• Translation audit command and automated tests.
• No United Agri customer data, business logic, or private configuration.

Compatibility

Component	Supported version
Frappe Framework	v16
ERPNext	v16
Python	3.10+

The installer stops with a clear error on unsupported Frappe major versions.

Installation

cd /home/frappe/frappe-bench
bench get-app https://github.com/amrpyt/frappe-arabic --branch main
bench --site your-site.example.com install-app frappe_arabic
bench --site your-site.example.com migrate
bench --site your-site.example.com clear-cache

Set the user language to Arabic from the user profile, then start a fresh browser session.

Updating

cd /home/frappe/frappe-bench
bench update --apps frappe_arabic
bench --site your-site.example.com migrate
bench --site your-site.example.com clear-cache

The after_migrate hook keeps the reviewed layer applied after app updates.

Manual synchronization

bench --site your-site.example.com execute frappe_arabic.api.sync

Force a rebuild of managed rows:

bench --site your-site.example.com execute frappe_arabic.api.sync --kwargs "{'force': True}"

Check status:

bench --site your-site.example.com execute frappe_arabic.api.status

User overrides

The app owns only rows whose contribution_docname starts with:

frappe_arabic:reviewed-v16

A translation row created by an administrator or another app is treated as a user override and is not replaced. Remove that custom row and run synchronization again to return to this app's reviewed translation.

Audit

Run the standalone payload audit:

python -m frappe_arabic.audit

Run tests:

python -m unittest discover -s tests -v

The audit checks:

• Empty source or translated strings.
• Broken placeholders.
• Changed URLs.
• Duplicate contextual keys.
• Payload count and revision.

Scope

The Arabic wording aims to be:

• Clear to Arabic-speaking ERP users.
• Context-aware rather than literal.
• Suitable for Egyptian business users without turning formal system labels into slang.
• Consistent across accounting, stock, buying, selling, manufacturing, setup, and website screens.

Contributing

See CONTRIBUTING.md. Every translation change must preserve placeholders and include a test when it fixes a contextual or recurring problem.

Licensing and attribution

Application code and the reviewed dataset are distributed under GPL-3.0-or-later. Upstream MIT attribution is retained in THIRDPARTYNOTICES.md.

This is an independent community project and is not an official Frappe Technologies product.