Project

Felunyx is a distro. This is where you can understand how it is being built.

This area organizes architecture, decisions, phases, and evidence without making you crawl through the whole repository. GitHub stores the source; the site explains the source.

In developmentPhase 2 · Reproducible ISO skeletonR → V → H

Understand the system

Felunyx in six territories

The constellation is an orientation map, not a dependency diagram. Choose an area to see what it groups together and which decisions support that direction.

Felunyx OS / Foundation

Foundation

The base that keeps Felunyx recognizably Linux: Arch, systemd, rolling release, kernels, and storage.

Direct Arch Linux base
Linux Zen + LTS
Btrfs for automatic installs

Decisions: D-001 · D-002 · D-003 · D-005 · D-006Canonical source: DECISIONS.md

Felunyx OS / Install & Recovery

Install & Recovery

The safe way into and back out of the system: ISO, Calamares, boot, restoration, and recovery without silent repair.

One ISO with Calamares
Home preserved by default
Analysis → Proposal → Confirmation → Result

Decisions: D-007 · D-008 · D-009 · D-076 · D-077 · D-079Canonical source: DECISIONS.md

Felunyx OS / Felunyx Platform

Felunyx Platform

The shared backend that keeps the GUI, CLI, and official profiles from becoming parallel systems with different consequences.

Same backend for GUI and CLI
Configuration provenance
Services shared across profiles

Decisions: D-014 · D-015 · D-016 · D-017 · D-018Canonical source: ARCHITECTURE.md

Felunyx OS / Packages & Updates

Packages & Updates

Sources stay visible, system changes become reviewable transactions, and risk is not hidden behind a pretty button.

Explicit sources
Plan before execution
Risk-aware snapshots

Decisions: D-004 · D-064 · D-066 · D-069 · D-073 · D-075Canonical source: ARCHITECTURE.md

Felunyx OS / Desktop Experiences

Desktop Experiences

KDE is the first reference; XFCE and Hyprland come later. Official profiles share the platform and an explicit support boundary.

KDE first
XFCE + Hyprland later
Compatible ≠ validated

Decisions: D-010 · D-011 · D-012 · D-014 · D-108Canonical source: DECISIONS.md

Felunyx OS / Whiskers & Research

Whiskers & Research

Whiskers is the public identity for the native desktop in development, not a shortcut. Research starts from a mature Wayland base and keeps a replaceable Qt/QML shell over Rust policy.

Outside the initial critical path
Mature compositor foundation
Qt/QML + Rust

Decisions: D-013 · D-019 · D-021 · D-022 · D-105 · D-106Canonical source: DECISIONS.md

Independent project

Felunyx is created and maintained by Mafuzyk.

The project is developed independently, with priorities guided by what can be tested, documented, and maintained clearly. Contributions are welcome and go through the same review and evidence process.

How we say something works

R, V, and H are different kinds of evidence.

Remote covers source, contracts, tests, manifests, builds, and CI. Virtual requires boot, installation, reboot, and integration in a VM. Hardware requires the physical world: firmware, GPU, network, storage, peripherals, power, and monitors.

Canonical snapshot: 210212ff384dmafuzyk/Felunyx-OS @ 210212ff384d

Remotein progress

Virtualpending

Hardwarenot required for this phase

Passing R does not mean passing V. Passing V does not mean passing H.

Where we are

A phase changes when the evidence closes, not when the calendar says so.

No decorative percentage and no invented release date. The summary below shows where the project came from, the active phase, the next step, and a more distant roadmap point.

Phase 1Available