Minimal, private-space-aware launcher for GrapheneOS
- Kotlin 98.3%
- Nix 1.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| app | ||
| gradle | ||
| .gitignore | ||
| build.gradle.kts | ||
| flake.lock | ||
| flake.nix | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle.kts | ||
Foyer
A minimal Android launcher for GrapheneOS, built to make a phone boring.
Foyer is inspired by µLauncher, Escape Launcher and mLauncher: a flat list of apps, a keyboard-first search box, and nothing else on the home screen.
What sets it apart is first-class support for the Android private space:
- Lock/unlock front and center. The state of the private space is the most prominent thing on the screen, and one tap locks it again.
- Pinned private apps. Apps from the private space can live on the home screen alongside everything else. Opening one while the space is locked triggers the system credential prompt and then launches the app once the profile is available. Foyer caches the label and icon of pinned private apps so they do not disappear from the home screen when the space locks.
Requirements
- Android 17 (API 37) or newer. GrapheneOS moved to Android 17 in June 2026.
- Foyer must be set as the default home app. The private-space APIs
(
LauncherAppsfor hidden profiles,UserManager.requestQuietModeEnabled) are only available to the current home role holder.
Integrations
- Weather. Install Breezy Weather,
enable its Gadgetbridge broadcast under data sharing, and add Foyer's package
(
sh.bentley.foyer, orsh.bentley.foyer.devfor debug builds) as a target. Foyer shows the current conditions, today's high and low, and the highest chance of rain for the rest of the day. Nothing is polled. - Agenda. With the calendar permission granted, the home page shows the next event from all visible calendars: one in progress, the next one today, or tomorrow's first.
Building
The repo ships a Nix flake with the Android SDK, JDK and Android Studio.
nix develop # SDK + JDK + Android Studio
nix develop .#ci # SDK + JDK only
./gradlew assembleDebug
Status
Early scaffold. See the roadmap below.
- Project skeleton, flake, Compose UI shell
- Enumerate apps across the personal profile and private space
- Lock/unlock the private space from the home screen
- Unlock-then-launch for private apps opened while locked
- Pinned home stack with shelves, persisted with DataStore
- Icon cache so pinned private apps keep their icons while locked
- Themed icons with icon pack fallback (Lawnicons)
- Weather (Breezy Weather via Gadgetbridge broadcast) and agenda line
- Drag-to-reorder on the home stack
- Omnibar search providers (contacts, settings, calculator)
- Hidden apps, renames, per-app open counters
- Gestures (swipe for notifications, double-tap to lock screen)
- Widgets
App bubbles ("bubble anything") in Android 17 are currently reserved for the system launcher: the task reparenting behind them needs privileged permissions that are not part of the public SDK. Foyer will adopt them when Google exposes a public entry point.
License
AGPL-3.0-or-later. See LICENSE.