Package Exports

@ihsandeen/aya
@ihsandeen/aya/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ihsandeen/aya) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

aya

"And We have fastened every man's deeds to his neck, and on the Day of Resurrection, We shall bring out for him a book which he will find wide open." (17:13)

Listen, we need to talk.

We live in a world of inputs and outputs. We spend our days in the terminal, typing commands, expecting results, fixing bugs, and pushing code. We are obsessed with our GitHub contribution graphs. We worry about our commit history. We stress over merge conflicts.

But have you ever stopped to think?

What about the repository of your life? What about the "issues" in your heart that have been open for years? What about the "commits" that the Angels are recording right now, at this very second?

That's why we built aya.

💡 The "Insider" Story: Why We Built This

You want to know the truth? This isn't just another developer tool. It’s a response to a modern problem.

We live in a time where we are hyper-connected to our repositories but disconnected from our purpose. We track every line of code, but we lose track of our spiritual state.

We realized something profound: We are optimizing our code, but we are not optimizing our lives.

The idea is simple yet radical: What if the very tools we use to build the dunya could be used to build our akhirah? What if git status could remind you of your status with Allah?

That is why aya exists. It is a bridge. It takes the language you already know—git, status, push, pull—and reorients it to help you track the most important project you will ever work on: Your Soul.

❓ Why "aya"?

People ask me, "Why did you call it aya?"

Look at the linguistics. In Arabic, Ayah (آية) doesn't just mean a "verse" of the Quran. It means a Sign. It means a Miracle. It means Evidence.

Every line of code you write can be an ayah—a sign of Allah's perfection. Every bug you fix can be a lesson. The sun is an ayah. The wind is an ayah. And this tool? It's a humble attempt to turn your terminal into a series of ayat—reminders that point you back to Him.

🚀 Quick Start (Bismillah)

You want to get started? Bismillah. It’s simple.

# 1. Install it globally (make it part of your system)
npm install -g @ihsandeen/aya

# 2. Set your intention (Niyyah) for the session
aya init

# 3. Check your connection to the Heavens
aya status

🔄 The Workflow (The Real Daily Grind)

You see, the life of a believer is a constant cycle. It's not a straight line. We mapped this spiritual reality to your developer workflow.

Command	The Spiritual Reality (The "Why")
`aya init`	Niyyah (Intention) Before you write a single line of code, ask yourself: Who is this for? If it's for ego, it's wasted. If it's for Allah, even a `console.log` becomes worship. This command sets that frame.
`aya status`	Salah & Connection Check You run `git status` to see changed files. `aya status` checks your connection to the Divine. It tells you: "Your heart is currently on branch 'dunya'." It checks if you've missed prayers. It's a reality check. Are you online with Allah, or did you timeout?
`aya diff`	The Precision of Divine Speech This isn't comparing two files. This is comparing words. Why did Allah use this specific word here and not its synonym? `aya diff` challenges you with linguistic nuances. It shows you that the Quran isn't just poetry; it's precision engineering.
`aya commit`	Amal (Deed) Every smile, every charity, every moment of patience—that's a commit. And unlike git, you can't `reset --hard` these commits once the time passes. Make them count.
`aya push`	Dua (Supplication) You have anxieties? You have bugs you can't fix? Push them up. The Server is always listening. The bandwidth is infinite.
`aya pull`	Rizq (Provision) We think we generate success. No. We just pull from the provision that was already written. Ask for guidance, and pull it down.
`aya blame`	Nafs (Self-Reproach) When code breaks, we check `git blame` to find the culprit. The believer looks in the mirror. Nafs al-Lawwama—the self-reproaching soul. It's healthy to admit your faults.
`aya repo`	Kitab (Book of Deeds) Imagine if you could see your Book of Deeds right now. This command opens a UI to visualize your spiritual contributions. It's eye-opening.

🛠️ The Toolkit (Equip Yourself)

A believer doesn't go into the battlefield unarmed. You need tools. You need reminders.

🕌 Worship & Practice

Command	Why you need this
`aya prayers`	Because Salah is the anchor. If this slips, everything slips.
`aya qibla`	Wherever you are, you need to know which way is Home 🕋.
`aya adhan`	Sometimes we get so lost in the code, we need a call to come back to success.
`aya wudu`	It's not just washing limbs. It's washing away the minor sins of the last few hours.
`aya tasbih`	Keep your tongue moist. It's light on the tongue, heavy on the scale.
`aya fast`	Discipline the body to feed the soul. It's a detox.
`aya zakat`	Your wealth isn't yours. You're just the manager. Purify it.
`aya friday`	The best day the sun has risen upon. Don't treat it like just another Friday.

📖 Knowledge & Reflection (Tadabbur)

Command	Why you need this
`aya tafsir`	Don't just read the Quran. Understand it. Dive deep.
`aya memorize`	Carrying the Words of Allah in your chest is a protection.
`aya seek`	Knowledge is an ocean. Start swimming.
`aya names`	You can't love someone you don't know. Learn His Names.
`aya parable`	Allah uses metaphors so we can understand complex realities.
`aya history`	We stand on the shoulders of giants. Know your legacy.
`aya hero`	The Sahaba were real people with real struggles. Learn from them.
`aya sunnah`	The Prophet (pbuh) was the walking Quran. Follow his footsteps.

🧠 Mindset & Character

Command	Why you need this
`aya journal`	Writing is a way to shackle fleeting wisdom. Document your journey.
`aya sabr`	Patience isn't passive. It's active endurance. It's grit.
`aya shukr`	Gratitude is the key to increase. You want more? Be grateful.
`aya adab`	You can have all the knowledge, but if you have no manners, you have nothing.
`aya invest`	"Shall I tell you of a trade that will save you?" Invest in your Akhirah.
`aya sleep`	Even your sleep can be worship. Prepare for the minor death.

🌍 World & Signs (Ayat)

Command	Why you need this
`aya nature`	Look at the sky. Look at the trees. They are all submitting. Are you?
`aya anatomy`	Look at your own hands. The complexity is a sign of the Designer.
`aya scene`	Visualize the Day of Judgment. It puts your compile errors in perspective.
`aya lens`	Shift your perspective. See the world through the lens of the Believer.
`aya mirror`	The believer is a mirror to his brother. What do you reflect?
`aya sound`	Let the recitation of the Quran soothe your heart.
`aya hijri`	Step out of the Gregorian construct. Live by the moon.

🤝 Contributing (Sadaqah Jariyah)

Listen, this project isn't about me. It's about us. It's a Sadaqah Jariyah—a continuing charity. Imagine someone using this tool and remembering Allah because of a line of code you wrote. That's a reward that continues even after you're gone.

Want to earn that reward? 👇

Clone it: git clone https://github.com/ihsandeen/aya.git
Install it: npm install
Build it: npm run build
Link it: npm link

If you find a bug, fix it. If you have an idea, build it. Do it with Ihsan (excellence).

May Allah accept this humble effort from us and make it a witness for us on the Day of Judgment. 🤲