Setup initial documentation site for TunaOS

docs/albacore.md

@@ -0,0 +1,73 @@
+---
+sidebar_position: 2
+---
+
+# Albacore (AlmaLinux)
+
+**Based on:** [AlmaLinux 10.0](https://almalinux.org/blog/2025-05-27-welcoming-almalinux-10/)
+
+Stable enterprise-grade desktop experience built on AlmaLinux foundation.
+
+## Features
+
+- ✨ **x86_64/v2** microarchitecture support for older CPUs (pre-2013)
+- 🖥️ **SPICE support** for qemu/libvirt virtualization
+- 🏢 **Enterprise Linux** foundation with AlmaLinux reliability
+
+## Downloads
+
+### Regular Edition
+**Image:** `ghcr.io/tuna-os/albacore:latest`
+
+**ISOs:**
+- [x86_64](https://download.tunaos.org/albacore-amd64.iso)
+- [x86_64_v2](https://download.tunaos.org/albacore-amd64-v2.iso) 
+- [arm64](https://download.tunaos.org/albacore-arm64.iso)
+
+### DX (Developer Experience)
+**Image:** `ghcr.io/tuna-os/albacore-dx:latest`
+
+**ISOs:**
+- [x86_64](https://download.tunaos.org/albacore-dx-amd64.iso)
+- [x86_64_v2](https://download.tunaos.org/albacore-dx-amd64-v2.iso)
+- [arm64](https://download.tunaos.org/albacore-dx-arm64.iso)
+
+### GDX (Graphical Developer Experience)
+**Image:** `ghcr.io/tuna-os/albacore-gdx:latest`
+
+**ISOs:**
+- [x86_64](https://download.tunaos.org/albacore-gdx-amd64.iso)
+- [x86_64_v2](https://download.tunaos.org/albacore-gdx-amd64-v2.iso)
+- [arm64](https://download.tunaos.org/albacore-gdx-arm64.iso)
+
+## Installation
+
+### Using Container Image
+```bash
+podman pull ghcr.io/tuna-os/albacore:latest
+```
+
+### Building ISO
+```bash
+curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
+-o build-bootc.sh
+chmod +x build-bootc.sh
+
+# Build Albacore ISO
+sudo ./build-bootc.sh iso ghcr.io/tuna-os/albacore:latest
+```
+
+## Differences from Project Bluefin
+
+For general functionality, refer to the [Project Bluefin Documentation](https://docs.projectbluefin.io).
+
+AlmaLinux-specific differences:
+- Based on AlmaLinux 10 instead of CentOS Stream
+- Enterprise Linux package ecosystem
+- For AlmaLinux-specific features, see [AlmaLinux Wiki](https://wiki.almalinux.org)
+
+## Community Support
+
+- **AlmaLinux**: [AlmaLinux Atomic SIG](https://chat.almalinux.org/almalinux/channels/sigatomic)
+- **Universal Blue**: [Discord Community](https://discord.gg/WEu6BdFEtp)
+- **TunaOS**: [Matrix Chat](https://matrix.to/#/%23tunaos:reilly.asia)

docs/bonito.md

@@ -0,0 +1,66 @@
+---
+sidebar_position: 4
+---
+
+# Bonito (Fedora)
+
+**Based on:** Fedora 42
+
+Cutting-edge experience with Bluefin LTS tooling ported to the latest Fedora release.
+
+:::note Development Status
+Bonito is still needing some work to get into a functional state. Check the [GitHub repository](https://github.com/tuna-os/tunaOS) for current progress.
+:::
+
+## Features
+
+- 🚀 **Latest Fedora** with cutting-edge packages
+- 🔄 **Bluefin LTS tooling** ported to modern Fedora
+- ⚡ **Pure bootc** implementation (unlike upstream Bluefin)
+
+## Downloads
+
+### Regular Edition
+**Image:** `ghcr.io/tuna-os/bonito:latest`
+
+**ISOs:** *Coming soon - check back for updates*
+
+## Installation
+
+### Using Container Image
+```bash
+podman pull ghcr.io/tuna-os/bonito:latest
+```
+
+### Building ISO
+```bash
+curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
+-o build-bootc.sh
+chmod +x build-bootc.sh
+
+# Build Bonito ISO (when available)
+sudo ./build-bootc.sh iso ghcr.io/tuna-os/bonito:latest
+```
+
+## Differences from Project Bluefin
+
+Bonito represents an experimental approach:
+
+- **Pure bootc**: Unlike upstream Bluefin which uses ostree, Bonito is built entirely on bootc
+- **Fedora 42 base**: Latest and greatest Fedora packages
+- **Modern toolchain**: Cutting-edge development environment
+
+For general Bluefin functionality, refer to the [Project Bluefin Documentation](https://docs.projectbluefin.io).
+
+## Development Status
+
+This variant is under active development. Contributions welcome! Track progress:
+
+- **Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
+- **Source**: [GitHub Repository](https://github.com/tuna-os/tunaOS)
+
+## Community Support
+
+- **Fedora**: [Fedora Discussion](https://discussion.fedoraproject.org/)
+- **Universal Blue**: [Discord Community](https://discord.gg/WEu6BdFEtp)
+- **TunaOS**: [Matrix Chat](https://matrix.to/#/%23tunaos:reilly.asia)

docs/installation.md

@@ -0,0 +1,111 @@
+---
+sidebar_position: 6
+---
+
+# Installation Guide
+
+TunaOS images can be installed in several ways, depending on your needs and preferences.
+
+## System Requirements
+
+| Component | Minimum | Recommended |
+|-----------|---------|-------------|
+| **CPU** | x86_64, ARM64 | x86_64, ARM64 |
+| **RAM** | 4 GB | 8 GB+ |
+| **Storage** | 20 GB | 50 GB+ |
+
+### Architecture Support
+
+- **x86_64**: Standard 64-bit Intel/AMD processors
+- **x86_64_v2**: Optimized for older CPUs (pre-2013) - available for Albacore and Yellowfin
+- **ARM64**: 64-bit ARM processors (Apple Silicon, Raspberry Pi 4+, etc.)
+
+## Installation Methods
+
+### Method 1: Download Pre-built ISOs
+
+The easiest way to get started is downloading pre-built ISO images:
+
+#### Albacore (AlmaLinux 10)
+- [x86_64](https://download.tunaos.org/albacore-amd64.iso) | [x86_64_v2](https://download.tunaos.org/albacore-amd64-v2.iso) | [arm64](https://download.tunaos.org/albacore-arm64.iso)
+- [DX x86_64](https://download.tunaos.org/albacore-dx-amd64.iso) | [DX x86_64_v2](https://download.tunaos.org/albacore-dx-amd64-v2.iso) | [DX arm64](https://download.tunaos.org/albacore-dx-arm64.iso)
+- [GDX x86_64](https://download.tunaos.org/albacore-gdx-amd64.iso) | [GDX x86_64_v2](https://download.tunaos.org/albacore-gdx-amd64-v2.iso) | [GDX arm64](https://download.tunaos.org/albacore-gdx-arm64.iso)
+
+#### Yellowfin (AlmaLinux Kitten 10)
+- [x86_64](https://download.tunaos.org/yellowfin-amd64.iso) | [x86_64_v2](https://download.tunaos.org/yellowfin-amd64-v2.iso) | [arm64](https://download.tunaos.org/yellowfin-arm64.iso)
+- [DX x86_64](https://download.tunaos.org/yellowfin-dx-amd64.iso) | [DX x86_64_v2](https://download.tunaos.org/yellowfin-dx-amd64-v2.iso) | [DX arm64](https://download.tunaos.org/yellowfin-dx-arm64.iso)
+- [GDX x86_64](https://download.tunaos.org/yellowfin-gdx-amd64.iso) | [GDX x86_64_v2](https://download.tunaos.org/yellowfin-gdx-amd64-v2.iso) | [GDX arm64](https://download.tunaos.org/yellowfin-gdx-arm64.iso)
+
+### Method 2: Build Your Own ISO
+
+Use the TunaOS build script to create custom ISOs:
+
+```bash
+# Download the build script
+curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
+-o build-bootc.sh
+chmod +x build-bootc.sh
+
+# Build an ISO for your preferred variant
+sudo ./build-bootc.sh iso ghcr.io/tuna-os/yellowfin:latest
+
+# Or build a VM image
+sudo ./build-bootc.sh qcow2 ghcr.io/tuna-os/yellowfin:latest
+```
+
+### Method 3: Container Runtime
+
+For testing or container-based workflows:
+
+```bash
+# Pull your preferred variant
+podman pull ghcr.io/tuna-os/albacore:latest
+podman pull ghcr.io/tuna-os/yellowfin:latest
+podman pull ghcr.io/tuna-os/bonito:latest
+podman pull ghcr.io/tuna-os/skipjack:latest
+```
+
+## Post-Installation
+
+After installation, TunaOS provides:
+
+### Pre-installed Applications
+- **GNOME 48.3**: Latest GNOME desktop environment
+- **Homebrew**: Package manager for CLI tools and fonts
+- **Flathub**: Full access to Flatpak applications
+
+### Getting Started
+1. Complete the initial setup wizard
+2. Install additional software via Flathub (Software app)
+3. Use Homebrew for command-line tools: `brew install <package>`
+4. Check out the [Project Bluefin documentation](https://docs.projectbluefin.io) for general usage
+
+### Variant-Specific Features
+
+#### DX (Developer Experience)
+- libvirt virtualization
+- Docker containers
+- VSCode IDE
+- Development toolchains
+
+#### GDX (Graphical Developer Experience)
+- NVIDIA drivers and CUDA
+- AI/ML development tools
+- Graphics and video editing software
+
+## Troubleshooting
+
+### Boot Issues
+- Ensure Secure Boot is disabled or properly configured
+- Check system requirements are met
+- Try the x86_64_v2 variant for older hardware
+
+### Installation Problems
+- Verify ISO integrity after download
+- Use a different USB creation tool (Ventoy, Rufus, dd)
+- Check available disk space
+
+### Getting Help
+- 🐛 **Report Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
+- 💬 **Chat**: [Matrix #tunaos:reilly.asia](https://matrix.to/#/%23tunaos:reilly.asia)
+- 🎮 **Discord**: [Universal Blue Community](https://discord.gg/WEu6BdFEtp)

docs/intro.md

@@ -0,0 +1,70 @@
+---
+sidebar_position: 1
+---
+
+# Welcome to TunaOS
+
+## A Collection of Cloud-Native Enterprise Linux OS Images
+
+TunaOS is a curated collection of **Bootc-based desktop operating systems** that are forks of [Bluefin LTS](https://github.com/ublue-os/bluefin-lts), built on modern container technology. This is an exploration of the flexibility of Bootc and a hope that some people believe in the Enterprise Linux Desktop.
+
+The plan is to provide a stable experience with up-to-date GNOME and modern tooling.
+
+## ✨ Key Features
+
+- **Latest GNOME**: Don't get stuck on a 3-year-old GNOME. We try to backport the latest Desktop features and bring them to the Enterprise Desktop
+  - Currently we're shipping GNOME `48.3` while EL will be stuck on GNOME `47` for the foreseeable future
+- **Anaconda WebUI & Live ISO**: Modern installation experience (pending upstream)
+- **Homebrew**: We bake Homebrew into the image, so all your CLI apps (and fonts) are just a brew command away
+- **Flathub by Default**: This is a no-brainer that isn't preset in our base images. Actually get all the Flatpaks that are generally available on the net
+
+## 🐠 Available Variants
+
+We ship 3 versions for each base, matching upstream:
+
+- **Regular**: See [Bluefin's excellent documentation](https://docs.projectbluefin.io/) for info
+- **DX (Developer Experience)**: Adding libvirt, Docker, VSCode, etc. [Learn more](https://docs.projectbluefin.io/dx)
+- **GDX (Graphical Developer Experience)**: Adding Nvidia drivers and CUDA. For Nvidia users/AI/VFX devs. [Learn more](https://docs.projectbluefin.io/gdx)
+
+### Images Available
+
+- **[Albacore](albacore)** - AlmaLinux 10 based
+- **[Yellowfin](yellowfin)** - AlmaLinux Kitten 10 based (closest to upstream Bluefin LTS)
+- **[Bonito](bonito)** - Fedora 42 based (cutting-edge)
+- **[Skipjack](skipjack)** - CentOS 10 based
+
+## 📋 System Requirements
+
+| Component | Minimum | Recommended |
+|-----------|---------|-------------|
+| **CPU** | x86_64, ARM64 | x86_64, ARM64 |
+| **RAM** | 4 GB | 8 GB+ |
+| **Storage** | 20 GB | 50 GB+ |
+
+## 🚀 Quick Start
+
+Ready to get started? Check out our [installation guide](installation) or download ISOs for your preferred variant:
+
+- [Albacore Downloads](albacore#downloads)
+- [Yellowfin Downloads](yellowfin#downloads)
+- [Bonito Downloads](bonito#downloads)
+- [Skipjack Downloads](skipjack#downloads)
+
+## 📚 External Documentation
+
+Since TunaOS is based on Bluefin LTS, most documentation can be found at:
+
+- [Project Bluefin Documentation](https://docs.projectbluefin.io) - Primary reference for shared functionality
+- [AlmaLinux Wiki](https://wiki.almalinux.org) - For AlmaLinux-specific information
+- [Universal Blue](https://universal-blue.org/) - Community and ecosystem info
+
+## 🤝 Community & Support
+
+- 🐛 **Report Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
+- 💬 **Matrix Chat**: [#tunaos:reilly.asia](https://matrix.to/#/%23tunaos:reilly.asia)
+- 🎮 **Discord**: [Universal Blue Community](https://discord.gg/WEu6BdFEtp)
+- 💬 **AlmaLinux Atomic SIG**: [AlmaLinux Atomic SIG](https://chat.almalinux.org/almalinux/channels/sigatomic)
+
+---
+
+*TunaOS is made by James in his free time, powered by [Bootc](https://github.com/bootc-dev/bootc), and inspired by [Bluefin](https://projectbluefin.io) and the [Universal Blue](https://universal-blue.org/) Community.*

docs/skipjack.md

@@ -0,0 +1,65 @@
+---
+sidebar_position: 5
+---
+
+# Skipjack (CentOS)
+
+**Based on:** CentOS 10
+
+CentOS-based variant providing a stable enterprise foundation.
+
+:::note Development Status
+This variant is currently under development. Check the [GitHub repository](https://github.com/tuna-os/tunaOS) for current progress.
+:::
+
+## Features
+
+- 🏢 **CentOS 10** enterprise foundation
+- 🔄 **Bootc-based** modern container approach
+- 🛡️ **Enterprise stability** with modern tooling
+
+## Downloads
+
+### Regular Edition
+**Image:** `ghcr.io/tuna-os/skipjack:latest`
+
+**ISOs:** *Coming soon - check back for updates*
+
+## Installation
+
+### Using Container Image
+```bash
+podman pull ghcr.io/tuna-os/skipjack:latest
+```
+
+### Building ISO
+```bash
+curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
+-o build-bootc.sh
+chmod +x build-bootc.sh
+
+# Build Skipjack ISO (when available)
+sudo ./build-bootc.sh iso ghcr.io/tuna-os/skipjack:latest
+```
+
+## Differences from Project Bluefin
+
+For general functionality, refer to the [Project Bluefin Documentation](https://docs.projectbluefin.io).
+
+CentOS-specific features:
+- Based on CentOS 10 stream packages
+- Enterprise Linux ecosystem compatibility
+- Upstream CentOS development alignment
+
+## Development Status
+
+This variant is under active development. Contributions welcome! Track progress:
+
+- **Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
+- **Source**: [GitHub Repository](https://github.com/tuna-os/tunaOS)
+
+## Community Support
+
+- **CentOS**: [CentOS Stream Discussion](https://forums.centos.org/)
+- **Universal Blue**: [Discord Community](https://discord.gg/WEu6BdFEtp)
+- **TunaOS**: [Matrix Chat](https://matrix.to/#/%23tunaos:reilly.asia)