# Vanta

Android 17, in true black. A custom ROM on **LineageOS 24.0** (`android-17.0.0_r1`) that replaces every surface you see — lock screen to recovery — with one design language: true-black OLED, a single line of cyan light, and glass that glows at its edge.

This is the full kit: the Vanta layer (`vendor/vanta`), the patch series, the local manifests (`manifest/vanta-zflip5.xml` for the Z Flip5), device uprev edits, the design system and every tool that builds and checks it. `AGENTS.md` is the working notes, `PLAN.md` the stages and gates, `FEATURES.md` the feature tracks.

```sh
VANTA_DEVICE=b5q tools/host-run.sh        # Galaxy Z Flip5, on a build host (BUILD.md)
VANTA_DEVICE=gsi_arm64 tools/host-run.sh  # GSI
tools/check.sh                            # every gate that runs without a build box
tools/preview/build.sh                    # render Home and the cover headlessly
```

**Building it?** Read BUILD.md: one clone, one command, what each step does and what to do if one fails.

The same pieces are also split out as their own repos:

| Repo | What it is |
|---|---|
| [vanta-apps](../vanta-apps) | The Vanta system apps (Home with the Flip5 cover, Hub, Voice, Edge, Arena, Guard, Aurora, Welcome) + VantaCore |
| [vanta-systemui](../vanta-systemui) | SystemUI patch series — Rail, lock clock, Deck, Dial, Power, Bar |
| [vanta-overlays](../vanta-overlays) | Runtime resource overlays, generated from the design tokens |
| [vanta-design](../vanta-design) | `tokens.json` + the render harness for every surface |
| [vanta-tones](../vanta-tones) | Vanta Tones — ringtones, notifications, alarms, UI sounds |
| [vanta-bootanimation](../vanta-bootanimation) | Boot animation renderer and packer |
| [vanta-recovery](../vanta-recovery) | Recovery art, palette and title |
| [vanta-fonts](../vanta-fonts) | IBM Plex Sans as the system font |
| [vanta-site](../vanta-site) | vanta.failure.fail |

## Targets

- **GSI** — building now
- **Galaxy Z Flip5** — next

No builds are published until one passes its boot gates on a real phone. Join the list at [vanta.failure.fail](https://vanta.failure.fail/#notify).

---

Part of [Vanta](https://vanta.failure.fail), an Android 17 ROM on LineageOS 24.0. Everything lives at [VantaGit](https://vanta.failure.fail/git/vanta).
