# Vanta features

`OVERHAUL.md` is the surface-by-surface map. This file is what exists. "Written"
means the code exists and passes its local check: the shadow Gradle compile for
apps, `git apply --check` against the synced upstream for patches. "Built"
means Soong compiled it on the box. Nothing has run on the phone yet.

## Identity (built into the first-boot layer)

- Boot animation, the cyan `#35E0FF` Monet accent, IBM Plex, device name, all
  applied once per `identity_version` by VantaSetup.
- Vanta Glass geometry: larger corner radii, 0.75× animations.
- Glasses desktop: `config_isDesktopModeSupported` forced on.
- S10+ only (cancelled): KernelSU-Next v3.3.0 in the kernel, dual-SIM slot fix, the s10 bridge.

## Apps (written, shadow-compiled)

| App | What it is |
|---|---|
| **VantaCore** | Shared library: generated `VantaTokens`, `vantaGlass` material, `VantaTheme`, the one spring, the config client, the bring-your-own-AI client and voice-loop state machine. The BYO port passes 26 checks mirrored from `rabbitos-v2/spec/byo.test.ts`. |
| **VantaHome** | The home screen. No icon grid: a stream of live glass cards (clock, live activities, Zo cards, now playing, alarm + battery ring, notifications) in the order you pick, three clock styles (Hero, Split, Minimal) and an optional greeting, a four- or five-slot dock with optional labels, a search-first drawer (3–5 columns, labels, most-used row, keyboard on open all optional) with an A–Z scrubber, and configurable double-tap (sleep / torch) and swipe-down (shade / search). |
| **Vanta Cover** (in VantaHome) | The Flip5's outer screen. When the phone closes the cover becomes display 0 and VantaHome recomposes as the cover face: swipeable panels — Clock (Split, Stack or Orbit; long-press to switch; optional seconds), Notifications (open or clear each, clear all), Now playing (art, seek bar, controls), Controls (torch, Focus/DND, sound/vibrate/silent, internet, Bluetooth, camera) and Apps (your picks, long-press to add or remove, plus all apps). Panel order, clock, background (black / glow / drifting aurora) and double-tap are set in Hub → Cover screen. Previews: `docs/preview/home/`. |
| **VantaVoice** | The system assistant. Hold power and a light orb rises from the rail and listens. It stops on silence, then transcribes, thinks and speaks through your own AI (OpenAI-compatible or Zo), falling back to device speech. It can read the screen on request. |
| **VantaHub** | Vanta's settings home, injected at the top of Settings. Look (accent, lock clock, rail, aurora, animation speed), Assistant (endpoint, key, models, test), Home (stream order, clock, greeting, dock, gestures, drawer, Zo cards), Cover screen (foldables only: panels, clock, seconds, background, gestures, apps), Edge, Glasses, Developer (developer options, USB and wireless debugging, stay awake, show taps, pointer location, animation speed, straight into the full menu), About this phone (device, software and hardware: chipset, CPU, memory, storage, every display, battery health and cycles, kernel, baseband, security patch, SELinux, uptime). The full LineageOS Settings app is underneath, untouched. It also hosts the config provider every other app reads. |
| **VantaEdge** | An edge panel: a glowing sliver on the screen edge opens a glass slab with pinned apps, tools (torch, screenshot, record, Voice, Wi-Fi, Bluetooth) and clipboard history. |
| **VantaAurora** | The default live wallpaper: GLES "Void Aurora" ribbons, >90% black pixels, tinted by time of day, blooms on wake, 30 fps cap. |
| **VantaWelcome** | The setup wizard, replacing Provision, Lineage's and Google's SetupWizard: Wi-Fi, Google sign-in (Play services' own flow), Play Protect off, accent, bring your own AI, and a tutorial for the rail. |
| **Google** | MindTheGapps for Android 17 built in (`VANTA_GAPPS`, default on for b5q and GSI): Play Store, Play services, Services Framework, contact/calendar sync, Restore. Play Protect's install-time and ADB-install verification are off from setup; Vanta Voice stays the default assistant (VantaRolesOverlay). |
| **Vanta Tones** | Sounds synthesised from scratch in one key (`tools/gen_tones.py`): ringtones, notifications, alarm, lock/unlock, charging, keyboard clicks. Every file has a `Vanta_` name; the defaults are re-pointed by `VantaSoundsOverlay` / `VantaSoundsSettingsOverlay`. |

## Personalization — Vanta Studio (designed + rendered)

The layer that makes Vanta feel like the jump from stock to a full OEM skin, not
a reskin. Source of truth is `design/tokens.json`; `gen_overlays.py` generates
`VantaAuras.kt`; `check.sh` (aura-engine block) gates it; browser renders are the
visual proof (`design/render/out/`).

| Feature | What it is | State |
|---|---|---|
| **Vanta Auras** | 6 system accent presets — Void, Ember, Verdant, Iris, Rose, Mono. Each re-points the Monet accent (whole framework) and, in-process, `LocalAura` (glass rim + glow + accent parts). bg stays true black on every aura. | tokens + `VantaAuras.kt` + `VantaTheme(aura=)` **written, VantaCore shadow-compiles**; rendered (`auras.png`) |
| **Vanta Studio** | The personalization hub: Aura swatches, Glass intensity (clear/frosted/deep/solid), Wallpaper depth (flat/parallax/deep), Icon shape (squircle/circle/seed/sharp), Always-on style. | config keys **written**; rendered (`studio.png`); page lands in VantaHub Look tab |
| **Vanta Ambient** | Redesigned always-on: thin split clock, weather, next event, media mini, charge ring, burn-in shift; style from Studio. | rendered (`ambient.png`); SystemUI/AOD patch next |
| **Vanta Capsule** | Live activities as lit glass capsules at the top of the home stream — navigation, timer, recording, call. Not a notch island. | rendered (`capsule.png`); VantaHome card type next |

Config keys (VantaCore/VantaConfig.kt): `LOOK_AURA`, `LOOK_GLASS`,
`LOOK_WALL_DEPTH`, `LOOK_ICON_SHAPE`, `AMBIENT_STYLE`. Every app reads them and
behaves sensibly when unset (Void, frosted, parallax, squircle, weather).

## System surfaces (patch series, `patches/`)

- **Vanta Rail** (`0001`): the navigation handle is a line of light (an accent
  gradient with a white core and a soft glow), dims over light apps, and can be
  hidden from VantaHub. The 3- and 2-button modes are removed.
- Lock screen and AOD clock, charging ripple, Quick Settings and shade, volume,
  power menu, status bar, Settings, recents: see `patches/` and `OVERHAUL.md`
  for state.
