# STARTHERE — mgf-brand-web

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

`mgf-brand-web` is the **Magogi brand-web kit** as an installable package — the
tokenized CSS + components + self-hosted fonts + logo/pattern assets that every
MGF web surface consumes (one source of truth, no copied CSS).

## For consumers

```bash
pip install mgf-brand-web
```
```python
from fastapi.staticfiles import StaticFiles
from mgf.brand_web import static_dir
app.mount("/static/brand", StaticFiles(directory=static_dir()), name="brand")
```
Then load `/static/brand/{tokens,fonts,base,components}.css` in your `<head>`
(see [README.md](README.md) + the kit
[static/README.md](src/mgf/brand_web/static/README.md)).

## For contributors

See [CONTRIBUTING.md](CONTRIBUTING.md). Standards inherited from
[mgf-common](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/).

## Quick links

| Resource | Where |
|---|---|
| What it is + how to consume | [README.md](README.md) |
| Class vocabulary + brand rules | [src/mgf/brand_web/static/README.md](src/mgf/brand_web/static/README.md) |
| Scope policy | [SCOPE.md](SCOPE.md) |
| Deps / consumers | [DEPS.md](DEPS.md) |
| Conformance ledger | [docs/inprogress/MGF_STANDARDS_CONFORMANCE.md](docs/inprogress/MGF_STANDARDS_CONFORMANCE.md) |
| Federation contract | [FEDERATION.md](FEDERATION.md) |
