initial commit

_nav.qd

@@ -0,0 +1,2 @@
+###! [{.icon {house}} {.projectname}](main.qd)
+

_setup.qd

@@ -0,0 +1,39 @@
+.doclang {en}
+.docdescription {Extensive documentation and guide on the technology stack fz-stack}
+
+.docauthors
+    - Frank Zechert
+        - email: frank@zechert.net
+
+.dockeywords
+    - fz-stack
+    - documentation
+
+.doctype {docs}
+.theme {darko} layout:{hyperlegible}
+
+.var {assets} {assets/}
+.var {logo} {{.assets}/fz-stack-icon.svg}
+.var {banner} {{.assets}/fz-stack-transparent.svg}
+.var {projectname} {fz-stack}
+.var {pagetitle} {fz-stack Documentation}
+
+.pagemargin {topleft}
+	.row gap:{20px} cross:{start}
+		[.logo::image label:{fz-stack Logo} figure:{false}](@)
+
+		[.projectname::text size:{larger}](@)
+
+
+.pagemargin {topright}
+	[.icon {git}](https://git.zechert.net/fz-stack)
+
+.htmloptions baseurl:{https://fz-stack.zechert.net}
+.htmloptions title:{.pagetitle}
+.ifnot {.docname::equals {.pagetitle}}
+	.htmloptions title:{.docname | .pagetitle}
+.ifnot {.docname::isnone}
+	.docname {.pagetitle}
+
+.numbering
+	- footnotes: i

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