Minimal, private-space-aware launcher for GrapheneOS
  • Kotlin 98.3%
  • Nix 1.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-03 21:23:21 +01:00
app Swipe down on the home page to pull the notification shade 2026-10-03 21:23:21 +01:00
gradle Home stack with shelves 2026-09-28 16:54:28 +01:00
.gitignore Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
build.gradle.kts Home stack with shelves 2026-09-28 16:54:28 +01:00
flake.lock Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
flake.nix Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
gradle.properties Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
gradlew Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
gradlew.bat Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
LICENSE Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00
README.md Top segment: date, weather from Breezy, next calendar event 2026-09-28 17:43:11 +01:00
settings.gradle.kts Scaffold Foyer launcher 2026-09-28 15:30:45 +01:00

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 (LauncherApps for 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, or sh.bentley.foyer.dev for 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.