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

# Quickstart

> Go from a new account to your first shared donor report

This guide walks the full golden path: create your account and organization, set up a project, deploy a field reporter, review their first report, and share a donor-ready impact page.

## Prerequisites

* A modern browser (Chrome, Safari, Firefox, or Edge)
* At least one person who can act as a field reporter (a teammate works fine for your first run)

## The golden path

**1. Create your account**

Go to [app.mirage.partners](https://app.mirage.partners) and sign up with your email or Google account. First-time users land on a welcome screen that points you to organization setup.

**2. Create your organization**

Give your organization a name, description, website, location, and contact details, and upload a logo if you have one handy. You're automatically added as a **steward**, the admin role that manages everything else in this guide.

See [Create your organization](https://mirage.mintlify.site/organization/create-your-organization.md) for the full walkthrough.

**3. Create your first project**

From your organization's **Projects** page, create a project: a title, a short summary, a location, and the metrics you want to track (for example "Wells dug" or "% of households with clean water access").

Metrics are the backbone of everything downstream. [Defining metrics](https://mirage.mintlify.site/projects/defining-metrics.md) explains the options.

**4. Create a reporting task**

Inside the project, create a **reporting task**: the work unit your field reporters respond to. Write clear instructions, add the questions you want answered, and toggle which evidence you need: photos, video, or audio.

See [Reporting tasks](https://mirage.mintlify.site/projects/reporting-tasks.md).

**5. Deploy your field reporters**

From your organization's **People** page, generate a 6-character **invite code** and share it with your reporters: in person, over SMS, or as a printable QR card. Reporters join at [report.mirage.partners](https://report.mirage.partners) by entering the code, and your tasks appear on their dashboard immediately.

See [Team & field reporters](https://mirage.mintlify.site/organization/team-and-field-reporters.md).

**6. Review the first submission**

When a reporter submits, the report shows up in your organization's **Approvals** queue. Mirage's AI will have already analyzed the evidence and proposed metric values with confidence scores. Review the answers and media, then **approve or reject** each proposed contribution; only approved data counts toward your project metrics.

See [Reviewing reports](https://mirage.mintlify.site/projects/reviewing-reports.md).

**7. Generate and share a donor report**

From the project page, generate a **donor report**. Mirage assembles your approved metrics, verified photos, and an AI-written narrative into a polished public page. Copy the link and send it to a donor, no login required on their end.

![Generated donor report page](https://mintcdn.com/mirage/eVR3n30GbOeZdkdj/images/donor-report-hero.png?fit=max\&auto=format\&n=eVR3n30GbOeZdkdj\&q=85\&s=309182d4446ed60a16398ef0333f831e)

The payoff: a public, donor-ready impact page built from your verified field data.

See [Generating donor reports](https://mirage.mintlify.site/donor-reports/generating-donor-reports.md).

> [!TIP]
>
> That's the whole loop: evidence in from the field, verified metrics out to donors. Everything else in these docs is depth on the steps above.

## Where to go next

> [card] [Get verified](https://mirage.mintlify.site/organization/verification.md)
>
> Submit your organization's documents to earn the verified badge donors see on your reports.

> [card] [Schedule revisits](https://mirage.mintlify.site/projects/revisit-tasks.md)
>
> Prove sustained impact by scheduling follow-up verification visits months down the line.

> [card] [Personalize for donors](https://mirage.mintlify.site/donor-reports/managing-donors.md)
>
> Add donor profiles with their priorities so generated reports speak to what they care about.

> [card] [Plans & billing](https://mirage.mintlify.site/organization/plans-and-billing.md)
>
> Subscribe to a plan and manage billing when you're ready to go beyond the trial.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.