> ## 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.

# Creating projects

> Set up an impact initiative with a location, metrics, SDG goals, and funding targets

A **project** is one impact initiative: a well-drilling program, a school build, a food distribution effort. Projects own everything downstream: reporting tasks, field reports, metrics, and donor reports.

## Create a project

From your organization's **Projects** page, create a new project. A short wizard walks you through:

* **Project name**: e.g. "Clean Water Wells - Rural Rwanda".
* **Description**: the elevator pitch. This appears on donor-facing pages, so write it for donors, not for internal use.
* **Website**: a link donors and reporters can use to learn more.
* **Hero image**: the visual anchor for the project and its donor reports.
* **Location**: an address or place; projects appear on maps in both the dashboard and the reporter app, and reporters can get directions to the site.
* **Metrics**: the numbers this project will prove. This is the most important design decision you'll make; see [Defining metrics](https://mirage.mintlify.site/projects/defining-metrics.md).
* **SDG goals**: tag the project with the UN Sustainable Development Goals it advances (1–17).
* **Funding**: an optional funding goal and amount raised. This is tracked manually for display alongside impact data. Money doesn't flow through Mirage.

![New project creation form](https://mintcdn.com/mirage/eVR3n30GbOeZdkdj/images/steward-new-project-form.png?fit=max\&auto=format\&n=eVR3n30GbOeZdkdj\&q=85\&s=bf3759442d92c9d849534f496a359a29)

The new-project wizard: project details, then a generated blueprint, launch preferences, and a success screen.

Once you have more than one project, switch the **Projects** page to **Map view** to see every project plotted by location, colored by status.

## Project status

| Status | Meaning |
| - | - |
| **Draft** | Being set up; not yet collecting reports. |
| **Active** | Live: reporters see its tasks and data is flowing. |
| **Paused** | Temporarily on hold. |
| **Archived** | Finished; kept for the record. |

## Guiding the AI (optional)

Project settings include an optional **custom AI guidance prompt**. Anything you write there is taken into account when Mirage's AI analyzes this project's reports and writes its donor narratives. This is useful for domain-specific framing ("water access should be evaluated against WHO standards", "always refer to participants as 'students'"). Organizations working with the Gloo Human Flourishing framework can also enable its values rubric per project.

## After creation

The project page becomes your hub for that initiative:

* **Reporting tasks**: the work you're asking reporters to do. See [Reporting tasks](https://mirage.mintlify.site/projects/reporting-tasks.md).
* **Reports**: submissions from the field, with review status.
* **Donor reports**: every impact page generated for this project.
* **Revisits**: scheduled follow-up verifications. See [Revisit tasks](https://mirage.mintlify.site/projects/revisit-tasks.md).

![Project page with impact metrics and actions](https://mintcdn.com/mirage/eVR3n30GbOeZdkdj/images/steward-project-page.png?fit=max\&auto=format\&n=eVR3n30GbOeZdkdj\&q=85\&s=0d3d47cd2e088cd8873c959955833f58)

A live project page: one-click actions, report stats, and impact metrics aggregated from approved contributions.

> [!TIP]
>
> Keep projects focused. One project = one story you want to tell donors. If two efforts would need different metrics or different donor narratives, make them two projects.

## Lifecycle

A project's **Settings** page has a **Lifecycle** card for status changes, cloning, and deletion:

* **Clone project** copies a project's framework (its metrics, reporting tasks, and questions) into a new draft project. Reports and funding are never copied.
* **Delete** removes a draft project outright. Once a project has any submitted field report, delete is disabled. Archive it instead so the record is preserved.


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