- Rust 98.7%
- JavaScript 1%
- PowerShell 0.2%
- Shell 0.1%
|
|
||
|---|---|---|
| .cargo | ||
| .forgejo/workflows | ||
| apps/fluxer | ||
| crates | ||
| docs | ||
| fixtures | ||
| packaging | ||
| tools | ||
| xtask | ||
| .gitattributes | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CLAUDE.md | ||
| clippy.toml | ||
| deny.toml | ||
| README.md | ||
| rust-toolchain.toml | ||
| rustfmt.toml | ||
Fluxer Native
A native Rust desktop client (Linux, Windows) for the Fluxer instance at
fluxer.forked.io, built with iced and wgpu to replace the Electron app.
Status: sub-project 1, Foundation, is built and under acceptance: login (password and
TOTP), guilds, channels, DMs, the message view with Markdown, sending, unread and mention
badges, desktop notifications, the settings skeleton, packaging. What is verified and what
is still open is in docs/acceptance/2026-11-foundation.md. Voice, video and the rest of
the Electron app's features belong to the later sub-projects listed in the program
overview.
Install
Releases are published on the Forgejo repository,
https://git.forked.io/charles/fluxer-native/releases, as native-<version> with three
files (none is published yet; see the acceptance record):
- Linux:
Fluxer-Native-<version>-linux-x86_64.AppImage.chmod +xit and run it. It needs glibc 2.35 or newer, ALSA'slibasound.so.2(libasound2on Debian and Ubuntu 22.04,libasound2t64on Ubuntu 24.04+,alsa-libon Fedora and Arch; PipeWire and PulseAudio serve it), a Vulkan driver, Wayland or X11, and for notifications and the stored login a session D-Bus with a notification service and a Secret Service (KWallet, GNOME Keyring). Without FUSE, run it withAPPIMAGE_EXTRACT_AND_RUN=1. - Windows:
Fluxer-Native-<version>-win-x64.exe, a portable executable; no installer and no Visual C++ redistributable needed (Windows 10 or newer). SHA256SUMSfor both (sha256sum --check SHA256SUMS).
The client stores its settings in the platform's configuration directory
(~/.config/fluxer-native/settings.toml on Linux), a message cache in the cache directory,
logs in the state directory and the session token in the OS keyring, never in a file.
fluxer --debug-info prints the version, the GPU adapters it found and every path it uses.
Run
fluxer # log in to https://fluxer.forked.io
fluxer --instance https://fluxer.example
FLUXER_LOG=fluxer_gateway=debug,info fluxer
fluxer --debug-info
All options, logging and --record are described in apps/fluxer/README.md.
Build from source
Rust 1.98.1 (pinned in rust-toolchain.toml; rustup installs it on first use). On
Debian or Ubuntu the build needs:
sudo apt-get install build-essential pkg-config curl git file libssl-dev libdbus-1-dev \
libwayland-dev libxkbcommon-dev libvulkan-dev libasound2-dev libpipewire-0.3-dev \
libfontconfig1-dev libglib2.0-dev
The LiveKit SDK's webrtc-sys compiles its C++ glue with clang 21 or newer (GCC is
refused): set CXX=clang++-21 (on Ubuntu 22.04 from apt.llvm.org, as CI does).
On Windows: the MSVC toolchain and the Windows SDK (its rc.exe embeds the icon).
cargo run -p fluxer # the client
cargo run -p fluxer -- --devserver # against recorded fixtures: no account, no network
cargo xtask ci # what CI runs: fmt, clippy, deny, parity, tests
cargo xtask package --target linux # dist/Fluxer-Native-<version>-linux-x86_64.AppImage
--devserver logs in as a demo user on an in-process fixture server and touches neither
your settings, your keyring nor your cache; it is how every task is developed and tested.
The other xtask commands (gen-theme, vendor-spec, extract-parity, parity-check)
are described in xtask/README.md.
Layout
| Path | What |
|---|---|
apps/fluxer |
the binary: effect runtime, configuration, logging |
crates/fluxer-proto |
wire types (REST models, gateway events), pure data |
crates/fluxer-api |
REST client |
crates/fluxer-gateway |
gateway state machine and WebSocket transport |
crates/fluxer-core |
application state and reducers; no I/O, no UI |
crates/fluxer-ui |
iced views and widgets; no I/O |
crates/fluxer-platform |
OS adapters: paths, settings file, keyring, cache, images, notifications |
crates/fluxer-status-api |
the companion-apps status server (127.0.0.1:21863) |
crates/fluxer-devserver |
fixture server for development and tests |
xtask |
repository tasks (cargo xtask ...) |
fixtures |
recorded REST and gateway data, scenarios, golden images |
docs |
specs and plans (superpowers/), acceptance records, the settings and voice parity lists, screenshots |
Every crate has a README.md saying what it does, how to use it and what it depends on.
Documents
docs/superpowers/specs/2026-11-11-fluxer-native-program-overview.md: the sub-projects and their order.docs/superpowers/specs/2026-11-11-fluxer-native-foundation-design.md: the Foundation design.docs/superpowers/plans/2026-11-11-foundation.md: the Foundation tasks and follow-ups.docs/acceptance/2026-11-foundation.md: the Foundation acceptance record.
Agents and contributors: read CLAUDE.md first.