Bahá’í Text Expansions for Espanso

Purpose

A community-maintained Espanso package for typing commonly used Bahá’í names, invocations, calendar terms, and transliterations with their proper Unicode characters.

Use case

Type forgiving forms such as bahaullah, yabahaullabha, ayyamiha, or nawruz and receive Bahá’u’lláh, Yá Bahá’u’l-Abhá, Ayyám-i-Há, or Naw-Rúz. Deliberate : shortcuts cover terms that might otherwise alter ordinary names or words.

The matches are cross-platform. Keep each operating system's Espanso config/default.yml local rather than synchronizing backend-specific settings.

How to use

Install Espanso, then:

espanso install bahai-text-expansions   --git https://forge.mehrabi.sh/kian/bahai-text-expansions.git   --external
espanso service restart

Common shortcuts:

:aua      → Alláh-u-Abhá
:yba      → Yá Bahá’u’l-Abhá
:yaali    → Yá ‘Alíyyu’l-A‘lá
:bi       → Bahá’í
:bhu      → Bahá’u’lláh
:abd      → ‘Abdu’l-Bahá
:badi     → Badíʿ
:baha     → Bahá
:ayyamiha → Ayyám-i-Há
:nawruz   → Naw-Rúz
:ridvan   → Riḍván

See REFERENCE.md for every shortcut and accepted spelling.

Design choices

• Automatic corrections use whole-word matching.
• Ambiguous names and ordinary words use deliberate : shortcuts.
• :baha is Bahá; :bi is the non-conflicting shortcut for Bahá’í.
• No platform-specific backend or keyboard configuration is included.

Contributing

Corrections and genuine spelling variants are welcome. See CONTRIBUTING.md.

This is an independent community package, not an official publication of the Bahá’í International Community.

License

MIT. See LICENSE.