From b1733b637b96c82864bbffd2a62b66a27f9ad10d Mon Sep 17 00:00:00 2001
From: Shiloh Fen <shiloh@shilohfen.com>
Date: Tue, 12 Aug 2025 01:51:04 -0500
Subject: [PATCH] Add Fedora Atomic documentation

Signed-off-by: Shiloh Fen <shiloh@shilohfen.com>
---
 content/docs/distros/Fedora_Atomic.md | 67 +++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 content/docs/distros/Fedora_Atomic.md

diff --git a/content/docs/distros/Fedora_Atomic.md b/content/docs/distros/Fedora_Atomic.md
new file mode 100644
index 0000000..3919c2f
--- /dev/null
+++ b/content/docs/distros/Fedora_Atomic.md
@@ -0,0 +1,67 @@
+---
+title: Fedora Atomic (Bazzite)
+---
+
+# Fedora Atomic
+
+This documentation applies to both Fedora's Atomic images (Silverblue, Kinoite, etc.), as well as Universal Blue images (Bazzite, Bluefin, etc.)
+
+# AtomicXR
+
+The recommended way to set up Fedora Atomic for VR is with [AtomicXR](https://tangled.sh/@matrixfurry.com/atomic-xr). See the [README](https://tangled.sh/@matrixfurry.com/atomic-xr/blob/main/README.md) for the most up-to date usage instructions.
+
+## Installation & Setup
+{{% hint info %}}
+You'll need to install [Homebrew](https://brew.sh/) to use AtomicXR. See [this page](https://docs.brew.sh/Homebrew-on-Linux#install) for installation instructions.
+If you're using a Universal Blue image (Bazzite, Bluefin, etc.), it's already installed for you.
+{{% /hint %}}
+
+1. Add the AtomicXR Homebrew tap:
+	```sh
+	brew tap matrixfurry.com/atomicxr https://tangled.sh/@matrixfurry.com/homebrew-atomicxr
+	```
+2. Install the AtomicXR CLI (`axr`):
+	```sh
+	brew install atomicxr-cli
+	```
+
+## [Envision](/docs/fossvr/envision)
+
+### Installation
+
+After installing the AtomicXR CLI, you can use `axr envision install` to install Envision.
+
+### Building profiles
+{{% hint note %}}
+It's bad practice to install development packages on your base system, to improve system stabilty and performance.
+AtomicXR will instead set up a container with all your build depencencies installed.
+Launching Envision in build mode will start it inside of that container.
+{{% /hint %}}
+
+To build profiles, right click Envision in your application menu and click "Launch in Build Mode".
+
+### Plugins
+AtomicXR can register [Plugins](/docs/fossvr/envision/#plugin-system) for all supported overlays & tools, so you don't need to manually add each one:
+```sh
+axr envision plugins register
+```
+
+## Overlays & Applications
+
+### Install
+- [WlxOverlay-S](/docs/fossvr/wlxoverlay-s): `brew install wlx-overlay-s`
+- [WayVR Dashboard](https://github.com/olekolek1000/wayvr-dashboard): `brew install wayvr-dashboard`
+- [Monado Tracking Origin Calibrator](/docs/fossvr/motoc): `brew install motoc`
+- [OSC Avatar Manager](https://github.com/galister/oscavmgr): `brew install oscavmgr vrc-advert`
+
+### OscAvMgr
+OscAvMgr [requires VrcAdvert to handle OscQuery](https://github.com/galister/oscavmgr?tab=readme-ov-file#setting-up-to-use-with-vrchat).
+
+A command is included to launch OscAvMgr and VrcAdvert together for you (use `openxr` for WiVRn):
+```sh
+axr oscavmgr start <babble|openxr|alvr>
+```
+
+## Support
+
+You can open an issue on [Tangled](https://tangled.sh/@matrixfurry.com/atomic-xr/issues), ask questions in [this post](https://discord.com/channels/1065291958328758352/1389409336580767775) on the LVRA Discord, or reach out to [the maintainer](https://woosh.link/matrixfurry.com) directly.