# منصة حسنات للبنّائين (Hasanat Builders Platform)

> Public builder documentation for Hasanat, an Arabic-first community that turns community needs into small volunteer-built projects. The documentation is written in Arabic; English pages exist where the previous builder guide had English text.

- How work flows: idea → spec → project (Building → Live). Ideas are proposed and upvoted on https://hasanat.dev, a monthly meeting picks a few, and each picked idea gets a written brief and spec.
- Shared services (subdomains, sign-in for external apps, databases, listings) are requested from the signed-in dashboard at https://platform.hasanat.dev/dashboard. Never put secrets in a request.
- Coding agents: start from https://github.com/hasanat-dev/starter and the verified skills pack at https://platform.hasanat.dev/skills/.
- Never generate, paraphrase or complete Quran or hadith text. Use the verified sources named in the resource bank.

## Documentation Sets

- [Abridged documentation](https://platform.hasanat.dev/llms-small.txt): a compact version of the documentation for منصة حسنات للبنّائين (Hasanat Builders Platform), with non-essential content removed
- [Complete documentation](https://platform.hasanat.dev/llms-full.txt): the full documentation for منصة حسنات للبنّائين (Hasanat Builders Platform)
- [Coding agents](https://platform.hasanat.dev/_llms-txt/coding-agents.txt): starter prompt, skills pack, starter, sign-in, database and deployment
- [Maintainers](https://platform.hasanat.dev/_llms-txt/maintainers.txt): runbook for handling shared-service requests

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [Hasanat skills pack manifest](https://platform.hasanat.dev/skills/hasanat-skills.manifest.json): version, SHA-256 checksums and sources of the five Hasanat skills
- [Hasanat starter](https://github.com/hasanat-dev/starter): public Astro and Cloudflare template for new Hasanat apps