- One-finger UI. Swipe up to go home, sideways to switch. Springs are interruptible mid-flight.
- Live cards. Windows keep rendering through every transition — no frozen screenshots.
- Home grid. Pages, drag-to-reorder, hide apps, dock. Long press for menu. Pull down to search.
- Status bar. Pull down on the right for the controls (radios, sliders, media, power, your own app shortcuts), on the left for Notification Center. New notifications drop in as banners.
- Lock screen. With
lock_on_blank, a dark screen locks: clock and notifications, swipe up for the PIN pad. - Rotation. Automatic rotation for fullscreen media and games.
- Hardware bindings. Full support for long/short/chorded hardware button mappings.
- Keyboard. wvkbd pops up automatically, at the right scale.
- Wide protocol support. Screencopy, screenshots, clipboard, idle inhibitor, session lock, external display mirroring.
- Power efficient uses systemd user slices for background tasks, uclamp to ensure smooth animations, and avoids unnecessary redraws. Also supports VRR (Depending on GPU support)
Important
This project is made with LLM assist, so if you have philosophical objections to that, please don't use it. I do not consider this to be a "slop" project as I've sunk a lot of time and effort into it, but I accept everyone has their own opinions on the matter.
Nightly packages are built from main and published to our registries on
code.bas.es. I daily drive them, but no stability guarantees until an actual
release.
Versions look like 0.1.0.20260913. Initial stable release planned soon.
The best supported path. Add the repo as a flake input and enable
programs.springchick.
Needs a systemd Nura install (pmbootstrap init → systemd).
sudo curl -JO --output-dir /etc/apk/keys \
https://code.bas.es/api/packages/marcus/alpine/key
echo 'https://code.bas.es/api/packages/marcus/alpine/edge/nightly' \
| sudo tee -a /etc/apk/repositories
sudo apk update && sudo apk add postmarketos-ui-springchickpostmarketos-ui-springchick pulls in springchick plus the session bits
(wvkbd + its systemd user unit, the portal stack, gnome-keyring, tinydm). If
you would rather wire that up yourself, apk add springchick alone is just the
compositor and its springchick-session wrapper.
Untested by me, would love some feedback on these.
sudo curl -fsSL https://code.bas.es/api/packages/marcus/debian/repository.key \
-o /etc/apt/keyrings/forgejo-marcus.asc
echo 'deb [signed-by=/etc/apt/keyrings/forgejo-marcus.asc] https://code.bas.es/api/packages/marcus/debian trixie nightly' \
| sudo tee /etc/apt/sources.list.d/springchick.list
sudo apt update && sudo apt install springchickUntested by me, would love some feedback on these.
curl -fsSL https://code.bas.es/api/packages/marcus/arch/repository.key \
| sudo pacman-key --add -
sudo pacman-key --lsign-key marcus@noreply.code.bas.esThe lsign-key step is required, or pacman -Sy rejects the repo database as
"unknown trust". Then append to /etc/pacman.conf:
[springchick-nightly]
Server = https://code.bas.es/api/packages/marcus/arch/springchick-nightly/$archsudo pacman -Sy springchickAll packages ship a Wayland session
(/usr/share/wayland-sessions/springchick.desktop), so greetd or GDM will list
springchick. /usr/share/springchick/config.example.toml documents every
option at its default — copy it to /etc/springchick/config.toml or
~/.config/springchick/config.toml.
Building the packages yourself: packaging/README.md.
- Closer integration with waydroid
- Home screen Folder / Widget support
- Richer search
- Initial 0.1 release
The Authorative home for this repo is https://code.bas.es/marcus/springchick - Github is a mirror to allow easier contributions and visibility.







