Refactor series

Containerfile

@@ -29,19 +29,15 @@ RUN --mount=type=bind,from=ctx,source=/,target=/ctx \
     --mount=type=cache,dst=/var/log \
     --mount=type=tmpfs,dst=/tmp \
     echo -e "\033[31mBUILD SCRIPT >>>>\033[0m" && \
-    /ctx/build.sh && \
-    echo -e "\033[31mINSTALL ZFS >>>>\033[0m" && \
-    /ctx/install_zfs.sh && \
-    echo -e "\033[31mLAYER APPIMAGES >>>>\033[0m" && \
-    /ctx/layered_appimages.sh && \
+    /ctx/01-build.sh && \
     echo -e "\033[31mOPT FIXER >>>>\033[0m" && \
-    /ctx/fix_opt.sh && \
+    /ctx/03-fix-opt.sh && \
     echo -e "\033[31mSYSTEM CONFIG >>>>\033[0m" && \
-    /ctx/config.sh && \
+    /ctx/04-config.sh && \
     echo -e "\033[31mKERENEL SCRIPT >>>>\033[0m" && \
-    /ctx/kernel_modules.sh && \
+    /ctx/05-kernel-modules.sh && \
     echo -e "\033[31mREMOTE GRABBER >>>>\033[0m" && \
-    /ctx/remote_grabber_new.sh && \
+    /ctx/06-remote-grabber.sh && \
     echo -e "\033[31mOSTREE COMMIT\033[0m" && \
     ostree container commit
 

README.md

@@ -1,51 +1,111 @@
 # DistinctionOS
 
-### DistinctionOS is built upon [Bazzite](https://github.com/ublue-os/bazzite). DistinctionOS is intended as a full experience and the opposite of minimalism. 
-##### Please note: I'm not a Developer, Just someone who keeps tinkering until something finally works and sometimes I learn from it. 
+> A fully-featured [Bazzite](https://github.com/ublue-os/bazzite)-based gaming and development environment
+
+[![Built on Bazzite](https://img.shields.io/badge/Built%20on-Bazzite-blue)](https://github.com/ublue-os/bazzite)
+[![Fedora Atomic](https://img.shields.io/badge/Fedora-Atomic-51A2DA)](https://fedoraproject.org/)
+[![License](https://img.shields.io/github/license/phantomcortex/distinctionos)](./LICENSE)
+
+**DistinctionOS** embraces the philosophy of abundance. a curated experience built for creators, gamers, and tinkerers who want it all, out of the box.
+
+---
+
+## 🚀 Quick Start
+
+Rebase your existing system to DistinctionOS:
 
-#### If you want to try out DistinctionOS you do so with:
 ```bash
+# Using bootc (recommended)
 sudo bootc switch ghcr.io/phantomcortex/distinctionos
+
+# Using rpm-ostree
+rpm-ostree rebase ostree-unverified-registry:docker://ghcr.io/phantomcortex/distinctionos:latest
 ```
-or 
+
+After reboot, run the first-time setup:
 ```bash
-rpm-ostree rebase ostree-unverified-registry:docker://ghcr.io/phantomcortex/distinctionos:latest
+ujust distinction-install
 ```
 
 ---
-## Miscellaneous packages that aren't included with bazzite
-- `docker` & `docker-compose`
-- `libheif-tools` (for .heic images thumbnails)
-- `flatpak-builder` 
-- `freerdp` (useful for [winboat](https://github.com/TibixDev/winboat) or [winapps](https://github.com/winapps-org/winapps))
-- `pandoc`
-- `totem-video-thumbnailer`  (Video thumbnails)
-- `Cider` is Music Client for Apple Music. **NOTE:** ***This is Cider version 3. You need to purchase an license from itch.io to use it, But it should be a one-time payment. See: https://cidercollective.itch.io/cider You will still need an active Apple Music subscription to use it.***
--  `Audacity-Freeworld` is better than fedora's default audacity because it ships patent encumbered codecs that fedora can't/won't ship in their official repositories.
-- [BlackBox-Terminal](https://github.com/yonasBSD/blackbox-terminal) is currently unmaintained But I still love it, Which is why it's here.
-- [xpadneo](https://github.com/atar-axis/xpadneo) is here for controller input over bluetooth and support for xbox series elite controllers (which I have and use)
-- [zoxide](https://github.com/ajeetdsouza/zoxide) (smart cd)
-- [dysk](https://github.com/Canop/dysk) 
-- Custom Image-raw thumbnailer via `dcraw` (tested with Sony's .ARW format from my own camera. Other formats untested.)
-- Custom dds texture thumbnailer via `ImageMagick` (This won't work for every last texture, but should work for most.)
-
- ### Miscellaneous /bin
-- `advcp` ( `cp` command with progress bar `advcp -g` )
-- `advmv` ( `mv` command with progress bar `advmv -g` )
-- `rpm-ostree-search-hl` (rpm-ostree search highlighting) (also aliased to `rosh`, use with `rosh search gcc`) 
-- `xiso` renamed from: [extract-xiso](https://github.com/XboxDev/extract-xiso) 
+
+## ✨ What's Included
+
+### 🎮 Gaming Enhancements
+- **xpadneo** - Enhanced Xbox controller support with full Bluetooth functionality
+
+### 🎨 Creative Tools
+- **Cider** - Premium Apple Music client ([requires license](https://cidercollective.itch.io/cider))
+- **Audacity Freeworld** - Full codec support for audio editing
+- **dcraw** - RAW image format support with thumbnail generation
+- **ImageMagick DDS thumbnailer** - Texture file previews
+
+### 🛠️ Development & Productivity
+- Docker & Docker Compose
+- Flatpak Builder
+- FreeRDP (for remote Windows applications)
+- Pandoc (universal document converter)
+- Zfs kernel module
+
+### 📦 Quality of Life
+- **zoxide** - Smart directory navigation (`z` command)
+- **dysk** - Modern disk usage analyzer
+- **advcp/advmv** - Progress bars for copy/move operations
+- Video thumbnail generation
+- HEIC image format support
+
+### 🎨 Theming
+- Kora icon theme (custom build)
+- Coordinated GTK styling
+
+---
+
+## 🔑 Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Immutable Base** | Built on Fedora Atomic for reliability and easy rollback |
+| **Automatic Updates** | Fresh images built every 5 days with latest packages |
+| **TPM Auto-Unlock** | Optional LUKS unlock with TPM 2.0 (setup via `ujust distinction-tpm-unlock-setup`) |
+| **ZSH by Default** | Oh My Zsh + Powerlevel10k configured automatically |
+| **Just Recipes** | Simple commands for common tasks (`ujust` for menu) |
 
 ---
-## Special thanks for making this unholy creation possible
-- [fedora linux](https://fedoraproject.org) and it's developers, maintainers, and it's community for being an incredible OS by default.
-- [UniveralBlue](https://github.com/ublue-os) and it's developers, maintainers, and contributers for making [Bazzite](https://github.com/ublue-os/bazzite), [Bluefin](https://github.com/ublue-os/bluefin), and the [image-template](https://github.com/ublue-os/image-template).
-- [Amy OS](https://github.com/astrovm/amyos) for being an example on a cleaner build system.
-- [vst-name's ublue-aurora-dx](https://github.com/vst-name/ublue-aurora-dx) for being an example of working rechunker
-
-## Community Examples
-
-- [m2Giles' OS](https://github.com/m2giles/m2os)
-- [bOS](https://github.com/bsherman/bos)
-- [Homer](https://github.com/bketelsen/homer/)
-- [Amy OS](https://github.com/astrovm/amyos)
-- [VeneOS](https://github.com/Venefilyn/veneos)
+
+## 🎯 Philosophy
+
+**DistinctionOS is for those who want:**
+- A complete, ready-to-use system without manual configuration
+- Gaming performance with development tools side-by-side
+- Professional applications without hunting through repositories
+
+If you prefer minimalism and building from scratch, this isn't your distribution—and that's perfectly fine.
+
+---
+
+## 📚 Documentation
+
+- **[Developer Documentation](./docs/developer.md)** - Build process, architecture, contributing
+- **[AI Assistant Context](./docs/claude.md)** - Complete project context for AI tools
+
+---
+
+## 🙏 Acknowledgements
+
+Special Thanks:
+
+- **[Fedora Project](https://fedoraproject.org)** - The foundation of it all
+- **[Universal Blue](https://github.com/ublue-os)** - Bazzite, Bluefin, and the image template
+- **[Bazzite](https://github.com/ublue-os/bazzite)** - The direct parent of this project
+- **Community Examples**: [Amy OS](https://github.com/astrovm/amyos), [vst-name's Aurora DX](https://github.com/vst-name/ublue-aurora-dx), [m2OS](https://github.com/m2giles/m2os), [bOS](https://github.com/bsherman/bos), [Homer](https://github.com/bketelsen/homer/), [VeneOS](https://github.com/Venefilyn/veneos)
+
+
+---
+
+<div align="center">
+
+**Built with ❤️ by [phantomcortex](https://github.com/phantomcortex)**
+
+*For those who want it all*
+
+</div>