# STARTHERE — mgf-cloud-web

> **Sibling application in the Magogi Foundation federation.**
> See [README.md](README.md) for what it does; see
> [FEDERATION.md](FEDERATION.md) for the federation contract.

`mgf-cloud-web` is the **Magogi cloud console** — a local, single-user web GUI
over the [`mgf-cloud`](https://codeberg.org/magogi-admin/mgf-cloud) library. It is
an **application** (run, not imported): there is no public import surface.

---

## To run it

```sh
uv tool install --editable '.' --index-url https://195.15.203.250.sslip.io/magogi/prod/+simple/
mgf-cloud-web          # → http://127.0.0.1:8787
```

Credentials resolve like `mgf-cloud`'s (`--clouds-yaml` / `$MGF_CLOUD_CLOUDS_YAML`
/ `OS_*` / a standard `clouds.yaml`), with `--cloud` selecting the entry. See
[README.md](README.md) for options.

---

## For contributors

See [CONTRIBUTING.md](CONTRIBUTING.md). Standards are inherited from
[mgf-common](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/).
Run `mgf-fed catch-up` periodically to verify federation drift; see
[FEDERATION.md](FEDERATION.md) §6.

---

## Quick links

| Resource | Where |
|---|---|
| What it does + how to run | [README.md](README.md) |
| Scope policy | [SCOPE.md](SCOPE.md) |
| Release notes | [CHANGELOG.md](CHANGELOG.md) |
| What we depend on / who depends on us | [DEPS.md](DEPS.md) |
| Conformance ledger | [docs/inprogress/MGF_STANDARDS_CONFORMANCE.md](docs/inprogress/MGF_STANDARDS_CONFORMANCE.md) |
| Lessons log | [LESSON_LEARNED.md](LESSON_LEARNED.md) |
| Federation contract | [FEDERATION.md](FEDERATION.md) |
| Cross-project standards | [mgf-standard/docs/standards/](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/) |
