initial commit

main.qd

@@ -0,0 +1,44 @@
+.include {docs}
+
+.css
+	h1 { opacity: 0; height: 0; margin: 0; padding:0; }
+
+.image {.banner} {fz-stack banner logo}
+
+## Welcome to the `fz-stack` Documentation
+
+`fz-stack` is a curated collection of system configurations, installation procedures, dotfiles, scripts,
+and tooling that define how I build and maintain my [Arch Linux][arch-linux]-based environment.
+
+It is not a standalone distribution; rather, it is a structured, reproducible framework for assembling a secure, modern,
+and highly customized Arch Linux system.
+
+This documentation describes the complete installation and configuration workflow used in my personal environment.
+While the stack is openly available, it is intentionally opinionated and optimized for my workflow.
+Users are encouraged to explore, adapt, and selectively integrate components that fit their own needs.
+
+A system deployed using fz-stack will:
+
+- use a single EFI partition and require UEFI
+- boot via a unified kernel image without an external bootloader
+- optionally enable Secure Boot for system integrity
+- employ full-disk encryption
+- use LVM2 for flexible volume management
+- support system hibernation
+- run a Wayland-based environment with [Hyprland][hyprland]
+- and include additional custom tooling, scripts, and configurations
+
+A system deployed with fz-stack **will not**:
+
+- support dual-booting with other operating systems
+- provide any warranty, guarantees, or assurances of fitness for purpose
+
+> Warning: This guide contains commands executed with and without elevated privileges.
+> Do not run commands you do not understand.
+> Always verify them against the relevant manual pages or the [Arch Linux Wiki][arch-linux-wiki].
+>
+> .emoji {warning} Incorrectly executed commands can cause irreversible data loss.
+
+[arch-linux]: https://archlinux.org
+[arch-linux-wiki]: https://wiki.archlinux.org/title/Main_page
+[hyprland]: https://hypr.land