> ## Documentation Index
> Fetch the complete documentation index at: https://docs.majarrah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Majarrah Docs

> The AI decision engine for real estate

<div className="max-w-7xl mx-auto px-6 py-16">
  <div className="grid grid-cols-1 lg:grid-cols-2 gap-12 items-center">
    <div>
      <p className="text-sm font-semibold tracking-widest uppercase" style={{ color: "#111111" }}>
        AI Decision Engine
      </p>

      # Make smarter real estate decisions

      <p className="text-lg text-gray-600 dark:text-gray-300 mt-4">
        Majarrah reasons about properties - not just lists them. Get structured verdicts on any property in seconds, whether you're a buyer, investor, broker, or building a product on top of our API.
      </p>
    </div>

    <div>
      <img src="https://mintcdn.com/majarrah/qGjman157rsb5h6O/images/og.png?fit=max&auto=format&n=qGjman157rsb5h6O&q=85&s=d59387e06f54418a9962280111675c6e" alt="Majarrah" className="rounded-xl w-full" width="1200" height="630" data-path="images/og.png" />
    </div>
  </div>

  <div className="mt-24">
    <h2 className="text-center text-3xl font-semibold mb-12">Explore</h2>

    <CardGroup cols={3}>
      <Card title="Platform Guide" icon="house" href="/quickstart">
        Get started with the Majarrah app — search properties, set your criteria, and get your first AI decision.
      </Card>

      <Card title="Decision API" icon="code" href="/api-reference/decisions/create">
        Integrate Majarrah's decision engine into your product. Structured verdicts with a single API call.
      </Card>

      <Card title="Authentication" icon="key" href="/api-reference/authentication">
        Generate your API key from the broker dashboard and start making decisions.
      </Card>
    </CardGroup>
  </div>

  <div className="mt-24">
    <h2 className="text-center text-3xl font-semibold mb-12">What is a decision?</h2>

    <CardGroup cols={2}>
      <Card title="Scoring — 1 credit" icon="chart-bar" href="/api-reference/decisions/create">
        Pure algorithmic comparison. Returns a score, verdict, and per-bucket breakdown. No AI cost, instant response.
      </Card>

      <Card title="Reasoning — 3 credits" icon="brain" href="/api-reference/decisions/create">
        Scoring engine + AI reasoning. Adds a plain-language explanation of the verdict in Arabic or English.
      </Card>

      <Card title="Error Reference" icon="triangle-exclamation" href="/api-reference/errors">
        All error codes, HTTP statuses, and response shapes in one place.
      </Card>

      <Card title="Decision Packs" icon="cube" href="/quickstart">
        Packs come in 5, 20, and 50 decisions. All packs include a 24-hour refund guarantee.
      </Card>
    </CardGroup>
  </div>
</div>