diff --git a/.github/TODO.md b/.github/TODO.md
deleted file mode 100644
--- a/.github/TODO.md
+++ /dev/null
@@ -1,5 +0,0 @@
-- [x] look into syncthing over nextcloud
-- [x] move mediawiki stuff
-- [x] move boot options
-- [] blog post on the perl annihilation
-- [] use lib.evalModules over lib.nixosSystem?
diff --git a/.github/images/blur.png b/docs/src/images/blur.png
rename from .github/images/blur.png
rename to docs/src/images/blur.png
--- a/.github/images/blur.png
+++ b/docs/src/images/blur.png
diff --git a/.github/images/blur.webp b/docs/src/images/blur.webp
rename from .github/images/blur.webp
rename to docs/src/images/blur.webp
--- a/.github/images/blur.webp
+++ b/docs/src/images/blur.webp
diff --git a/.github/images/lightmode.png b/docs/src/images/lightmode.png
rename from .github/images/lightmode.png
rename to docs/src/images/lightmode.png
--- a/.github/images/lightmode.png
+++ b/docs/src/images/lightmode.png
diff --git a/.github/images/lightmode.webp b/docs/src/images/lightmode.webp
rename from .github/images/lightmode.webp
rename to docs/src/images/lightmode.webp
--- a/.github/images/lightmode.webp
+++ b/docs/src/images/lightmode.webp
diff --git a/.github/images/main.png b/docs/src/images/main.png
rename from .github/images/main.png
rename to docs/src/images/main.png
--- a/.github/images/main.png
+++ b/docs/src/images/main.png
diff --git a/.github/images/main.webp b/docs/src/images/main.webp
rename from .github/images/main.webp
rename to docs/src/images/main.webp
--- a/.github/images/main.webp
+++ b/docs/src/images/main.webp
diff --git a/.github/images/nvim.png b/docs/src/images/nvim.png
rename from .github/images/nvim.png
rename to docs/src/images/nvim.png
--- a/.github/images/nvim.png
+++ b/docs/src/images/nvim.png
diff --git a/.github/images/nvim.webp b/docs/src/images/nvim.webp
rename from .github/images/nvim.webp
rename to docs/src/images/nvim.webp
--- a/.github/images/nvim.webp
+++ b/docs/src/images/nvim.webp
diff --git a/.github/images/topology.png b/docs/src/images/topology.png
rename from .github/images/topology.png
rename to docs/src/images/topology.png
--- a/.github/images/topology.png
+++ b/docs/src/images/topology.png
diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml
--- a/.github/workflows/check.yml
+++ b/.github/workflows/check.yml
@@ -36,6 +36,7 @@ uses: DeterminateSystems/nix-installer-action@main
         with:
           source-url: https://install.lix.systems/lix/lix-installer-x86_64-linux
           logger: pretty
+          diagnostic-endpoint: ""
 
       - name: Nix Magic Cache
         uses: DeterminateSystems/magic-nix-cache-action@main
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,48 @@
+name: Build and deploy docs
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - "docs/**/*"
+      - ".github/workflows/docs.yml"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Lix
+        uses: DeterminateSystems/nix-installer-action@main
+        with:
+          source-url: https://install.lix.systems/lix/lix-installer-x86_64-linux
+          logger: pretty
+          diagnostic-endpoint: ""
+
+      - name: Build Linux packages
+        run: "nix build -L .#docs"
+
+      - name: Upload Pages Artifact
+        uses: "actions/upload-pages-artifact@v3"
+        with:
+          path: "result/"
+
+  deploy:
+    needs: "build"
+    runs-on: "ubuntu-latest"
+
+    permissions:
+      pages: "write"
+      id-token: "write"
+
+    environment:
+      name: "github-pages"
+      url: "${{ steps.deployment.outputs.page_url }}"
+
+    steps:
+      - name: "Deploy to GitHub Pages"
+        id: "deployment"
+        uses: "actions/deploy-pages@v4"
diff --git a/.github/workflows/generate-topology.yml b/.github/workflows/generate-topology.yml
--- a/.github/workflows/generate-topology.yml
+++ b/.github/workflows/generate-topology.yml
@@ -28,7 +28,7 @@
       - name: Move files
         run: |
           nix shell nixpkgs#imagemagick
-          magick ./result/topology.svg ./.github/images/topology.png
+          magick ./result/topology.svg ./docs/src/images/topology.png
 
       - name: Commit & Push
         uses: endbug/add-and-commit@v9
diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -34,26 +34,6 @@ </details>
 
 ![image of my flakes topology](./.github/images/topology.png)
 
-<!--toc:start-->
-
-- [Foreword](#foreword)
-- [What does this repo provided](#what-does-this-repo-provided)
-- [Config layout](#config-layout)
-- [Usage Notes](#usage-notes)
-  - [Using the templates](#using-the-templates)
-  - [Shortcuts](#shortcuts)
-  - [Installation Notes](#installation-notes)
-    - [NixOS](#nixos)
-      - [Dual boot](#dual-boot)
-    - [macOS](#macos)
-  - [Small bits](#small-bits)
-- [Additional notes](#additional-notes)
-  - [Resources](#resources)
-  - [Projects / Configurations](#projects-configurations)
-  - [People](#people)
-
-<!--toc:end-->
-
 ### Foreword
 
 This repository contains my **personal** configuration for my systems, so its really important that you know it's **personal** and not everything will fit your needs.
@@ -62,9 +42,6 @@
 > [!WARNING]
 > Also to note that this configuration will **not** work if you do not change any of the [secrets](./secrets) since they are encrypted.
 
-> [!TIP]
-> You can find some cool blogs and people at the bottom of this file, or [click here](#additional-notes)
-
 ### What does this repo provided
 
 - Several applications and tools for my needs, but you can choose the one that best suits your needs
@@ -77,183 +54,7 @@ - Sensible defaults, so you can get started quickly
 - Docs kind of
 - [Catppuccin](https://github.com/catppuccin/catppuccin) everywhere, with a hint of [evergarden](https://github.com/comfysage/evergarden)
 
-### Config layout
-
-- 🏠 [home](./home/) Where all home-manager configurations lie
-- 🖥️ [systems](./systems/)
-  - ☀️ [Amaterasu](./systems/amaterasu) My high-end gaming machine
-  - 🐉 [Hydra](./systems/hydra/) A super mid spec laptop
-  - ⚸ [Lilith](./systems/lilith/) A NixOS ISO image that can be quickly deployed and accessed via ssh
-  - ⚖️ [minerva](./systems/minerva/) A server configuration for some of my infrastructure
-  - 𖤍 [Valkyrie](./systems/valkyrie/) A WSL2 host, designed to be a development environment on Windows
-  - 💮 [Tatsumaki](./systems/tatsumaki/) A MacBook Air, configured to last a whole day of university
-- 🧩 [parts](./parts/) NixOS parts breaking down the complex configuration into smaller more manageable chunks
-  - 📚 [lib](./parts/lib/) Useful repeated functions
-  - 🛠️ [templates](./parts/templates/) Templates for setting up development environments
-  - 👾 [modules](./parts/modules/) Exported modules for NixOS, home-manager and Nix Darwin
-- 🔌 [modules](./modules/)
-  - [base](./modules/base/) The base configuration settings, which are common between all systems
-  - [darwin](./modules/darwin/) Pre-made modules for exclusively darwin systems
-  - [nixos](./modules/nixos/) Pre cooked modules for exclusively nixos systems
-  - [iso](./modules/iso/) Pre-configured modules prepared for making NixOS iso images
-  - [extra](./modules/extra) Extra configuration modules, for home-manager and Nix Darwin and NixOS
-  - [profiles](./modules/profiles/) Pre-made profiles for different system types
-    - [hardware](./modules/profiles/hardware) Optimized settings for different devices (e.g., laptop, servers, desktop)
-    - [meta](./modules/profiles/meta) Optimized configurations for different natures (e.g., headless, graphical)
-
-> [!TIP]
-> When looking for my custom modules or packages you should direct yourself to [isabelroses/beapkgs](https://github.com/isabelroses/beapkgs). If you are specifically looking for remote modules (sometimes not clearly labelled), it is worth looking through the [beapkgs docs](https://isabelroses.github.io/beapkgs/).
-
-### Usage Notes
-
-#### Using the templates
-
-To use the templates there are two commands you can run, they are:
-
-- `nix flake init -t github:isabelroses/dotfiles#<template>` to initialize a new project with the template
-- `nix flake new -t github:isabelroses/dotfiles#<template> <out dir>` to create a new project in the specified directory
-
-For the full list of templates you can look in the [templates](./parts/templates/) directory or run `nix flake show github:isabelroses/dotfiles`.
-
-<details>
-<summary>
-
-#### Shortcuts
-
-</summary>
-
-| SKHD Shortcut                 | Hyprland Shortcut               | What it does               |
-| ----------------------------- | ------------------------------- | -------------------------- |
-| <kbd>CMD+RETURN</kbd>         | <kbd>SUPER+RETURN</kbd>         | open terminal              |
-|                               | <kbd>SUPER+B</kbd>              | open browser               |
-|                               | <kbd>SUPER+C</kbd>              | open editor                |
-|                               | <kbd>SUPER+O</kbd>              | open notes                 |
-|                               | <kbd>SUPER+E</kbd>              | open file manager          |
-| <kbd>CMD+Q</kbd>              | <kbd>SUPER+Q</kbd>              | quit                       |
-| <kbd>CMD+D</kbd>              | <kbd>SUPER+D</kbd>              | launcher                   |
-|                               | <kbd>SUPER+F</kbd>              | full screen                |
-| <kbd>CMD+CTRL+[number]</kbd>  | <kbd>SUPER+[number]</kbd>       | open workspace [number]    |
-| <kbd>CMD+SHIFT+[number]</kbd> | <kbd>SUPER+SHIFT+[number]</kbd> | move to workspace [number] |
-
-</details>
-
-#### Installation Notes
-
-##### NixOS
-
-You might want to use the [lilith iso configuration](./systems/lilith/), provided in this repository
-
-- To build it you can run `nix build .#images.lilith`.
-- Or you can download it from the [release page](https://github.com/isabelroses/dotfiles/releases/latest).
-
-If you opted to use the lilith iso image, you can use the `iznix-install` script to install it on your system.
-Otherwise, you can follow the steps below.
-
-1. Install [NixOS](https://nixos.org/download), you might need to follow the [manual](https://nixos.org/manual/nixos/stable/index.html#sec-installation)
-2. Clone this repository to `~/.config/flake`
-3. Run `sudo nixos-rebuild switch --flake ~/.config/flake#<host>`
-
-###### Dual boot
-
-If you would like to set up duel boot with Windows, you should consider enabling secure boot.
-To do so you should follow the [lanzaboote guide](https://github.com/nix-community/lanzaboote/blob/0bc127c631999c9555cae2b0cdad2128ff058259/docs/QUICK_START.md).
-
-1. Locate the Windows EFI partition
-
-```sh
-lsblk -o NAME,FSTYPE,SIZE,MOUNTPOINT
-```
-
-2. Mount the Windows EFI partition
-
-```sh
-sudo mkdir /mnt/winboot
-sudo mount /dev/nvme0n1p1 /mnt/winboot
-```
-
-3. Copy the Windows EFI files to the NixOS EFI partition
-
-```sh
-sudo rsync -av /mnt/winboot/EFI/Microsoft/ /boot/EFI/Microsoft/
-```
-
-4. Finally, clean up
-
-```sh
-sudo umount /mnt/winboot
-sudo rmdir /mnt/winboot
-```
-
-##### macOS
-
-1. Install [Lix](https://lix.systems/install/) the package manager
-
-```sh
-curl -sSf -L https://install.lix.systems/lix | sh -s -- install
-```
-
-2. Then enter a nix development shell in order to use git and other required tools
-
-```sh
-nix develop
-```
-
-3. Now we need to switch to the configuration, remember to replace `<host>` with the system you are configuring
-
-```sh
-just provision <host>
-```
-
-#### Small bits
-
-- Anything starting with `garden` is likely a part of my internal module. So keep that in mind when reading the code.
-
-### Additional notes
-
-#### Resources
-
-A collection of resources from people who just make good stuff.
-
-- [Xe's blog](https://xeiaso.net/blog/)
-- [The aux forum](https://forum.aux.computer/)
-- [Viper's Blog](https://ayats.org/)
-- [Nix Pills](https://nixos.org/guides/nix-pills/), this one might be a bit much if you don't care too much about the internals
-- [Solène's Blog](https://dataswamp.org/~solene)
-- [Jade Lovelace's blog](https://jade.fyi/)
-- [Astrid's blog](https://astrid.tech/t/nixos)
-- [nixpkgs news](https://nixpkgs.news/)
-- [nix.dev](https://nix.dev/)
-- [cafkafk's blog](https://cafkafk.dev/)
-- [zimbatm's blog](https://zimbatm.com/notes)
-- [my own blog](https://isabelroses.com/blog/tag/nix)
-- [official wiki](https://wiki.nixos.org/wiki/NixOS_Wiki)
-- [zero to nix](https://zero-to-nix.com/start)
-
-#### Projects / Configurations
-
-These are some configuration or projects that I have taken inspiration from or find to be of a high quality that people should also consider reading.
-
-- [lovesegfault/nix-config](https://github.com/lovesegfault/nix-config)
-- [jakehamilton/config](https://github.com/jakehamilton/config)
-- [flake parts](https://flake.parts/)
-- [nixos-hardware](https://github.com/NixOS/nixos-hardware)
-- [getchoo/flake](https://github.com/getchoo/flake)
-- [uncenter/flake](https://github.com/uncenter/flake)
-
-#### People
-
-Thanks to all these people otherwise this config and I would be lost.
-
-- [comfysage](https://github.com/comfysage), for making my day that bit brighter and occasionally putting me on your back
-- [getchoo](https://github.com/getchoo), for making catppucin/nix and helping a ton
-- [nullishamy](https://github.com/nullishamy), for tricking me into using NixOS
-- [nekowinston](https://github.com/nekowinston), for fixing half my problems
-- [jakehamilton](https://github.com/jakehamilton), for teaching me too much about modules
-- [nyxkrage](https://github.com/nyxkrage), for being there to answer my questions
-- [NotAShelf](https://github.com/notashelf), lots of valuable information
-- [Minion3665](https://github.com/Minion3665), for making me write better docs
-- [Thorn](https://git.avery.garden/thorn), picrewnix????
-
-And of course all those who star this repo!
+> [!NOTE]
+> Please read [the documentation](https://dotfiles.isabelroses.com/)
 
 [![Star History Chart](https://api.star-history.com/svg?repos=isabelroses/dotfiles&type=Date)](https://star-history.com/#isabelroses/dotfiles&Date)
diff --git a/docs/book.toml b/docs/book.toml
new file mode 100644
--- /dev/null
+++ b/docs/book.toml
@@ -0,0 +1,19 @@
+[book]
+authors = ["Isabel Roses", "Robin Roses"]
+language = "en"
+multilingual = false
+src = "src"
+title = "dotfiles"
+
+[build]
+build-dir = "./dist"
+
+[output.html]
+default-theme = "latte"
+preferred-dark-theme = "mocha"
+git-repository-url = "https://dotfiles.isabelroses.com"
+git-repository-icon = "fa-code-fork"
+cname = "dotfiles.isabelroses.com"
+additional-css = ["./theme/catppuccin.css", "./theme/catppuccin-alerts.css"]
+
+[preprocessor.alerts]
diff --git a/docs/src/README.md b/docs/src/README.md
new file mode 100644
--- /dev/null
+++ b/docs/src/README.md
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
new file mode 100644
--- /dev/null
+++ b/docs/src/SUMMARY.md
@@ -0,0 +1,20 @@
+# Summary
+
+[Introduction](README.md)
+
+# Config
+
+- [installation](config/installation.md)
+- [layout](config/layout.md)
+- [shortcuts](config/shortcuts.md)
+- [templates](config/templates.md)
+- [adding systems](config/adding-systems.md)
+- [adding users](config/adding-users.md)
+
+# Further Reading
+
+- [further reading](further-reading.md)
+
+# Misc
+
+- [previews](misc/previews.md)
diff --git a/docs/src/config/adding-systems.md b/docs/src/config/adding-systems.md
new file mode 100644
--- /dev/null
+++ b/docs/src/config/adding-systems.md
@@ -0,0 +1,36 @@
+The systems are configured in `/systems/<hostname>`.
+
+To set up a system configuration it must be declared in `/systems/default.nix`.
+
+- arch:
+
+  - default: "x86_64"
+  - options: "x86_64", "aarch64"
+
+- target:
+
+  - default: "nixos"
+  - options: "nixos", "darwin", "iso"
+
+- system:
+
+  - default: `constructSystem config.hosts.<hostname>.target config.hosts.<hostname>.arch`
+  - note: This is a function that constructs the system configuration, it will make `x86_64-linux` by from the `target` and `arch` attributes or `aarch64-darwin`
+
+- deployable:
+
+  - default: false
+
+- modules:
+
+  - default: "[ ]"
+  - options:
+    - laptop: for laptop type configurations
+    - desktop: for desktop type configurations
+    - server: for server type configurations
+    - wsl: for wsl systems
+    - gaming: for systems that have a graphical interface
+    - headless: for systems that do not have a graphical interface
+
+- specialArgs:
+  - default: "{ }"
diff --git a/docs/src/config/adding-users.md b/docs/src/config/adding-users.md
new file mode 100644
--- /dev/null
+++ b/docs/src/config/adding-users.md
@@ -0,0 +1,4 @@
+The user side is configured in `/home/<user>`.
+
+To set up a user configuration it must be declared in
+`/modules/base/users/options.nix` and `/modules/base/users/<user>.nix` can be used for anything that is not preconfigured by `/modules/base/users/mkusers.nix`.
diff --git a/docs/src/config/installation.md b/docs/src/config/installation.md
new file mode 100644
--- /dev/null
+++ b/docs/src/config/installation.md
@@ -0,0 +1,64 @@
+# NixOS
+
+You might want to use the [lilith iso configuration](./systems/lilith/), provided in this repository
+
+- To build it you can run `nix build .#images.lilith`.
+- Or you can download it from the [release page](https://github.com/isabelroses/dotfiles/releases/latest).
+
+If you opted to use the lilith iso image, you can use the `iznix-install` script to install it on your system.
+Otherwise, you can follow the steps below.
+
+1. Install [NixOS](https://nixos.org/download), you might need to follow the [manual](https://nixos.org/manual/nixos/stable/index.html#sec-installation)
+2. Clone this repository to `~/.config/flake`
+3. Run `sudo nixos-rebuild switch --flake ~/.config/flake#<host>`
+
+## Dual boot
+
+If you would like to set up duel boot with Windows, you should consider enabling secure boot.
+To do so you should follow the [lanzaboote guide](https://github.com/nix-community/lanzaboote/blob/0bc127c631999c9555cae2b0cdad2128ff058259/docs/QUICK_START.md).
+
+1. Locate the Windows EFI partition
+
+```sh
+lsblk -o NAME,FSTYPE,SIZE,MOUNTPOINT
+```
+
+2. Mount the Windows EFI partition
+
+```sh
+sudo mkdir /mnt/winboot
+sudo mount /dev/nvme0n1p1 /mnt/winboot
+```
+
+3. Copy the Windows EFI files to the NixOS EFI partition
+
+```sh
+sudo rsync -av /mnt/winboot/EFI/Microsoft/ /boot/EFI/Microsoft/
+```
+
+4. Finally, clean up
+
+```sh
+sudo umount /mnt/winboot
+sudo rmdir /mnt/winboot
+```
+
+# macOS
+
+1. Install [Lix](https://lix.systems/install/) the package manager
+
+```sh
+curl -sSf -L https://install.lix.systems/lix | sh -s -- install
+```
+
+2. Then enter a nix development shell in order to use git and other required tools
+
+```sh
+nix develop
+```
+
+3. Now we need to switch to the configuration, remember to replace `<host>` with the system you are configuring
+
+```sh
+just provision <host>
+```
diff --git a/docs/src/config/layout.md b/docs/src/config/layout.md
new file mode 100644
--- /dev/null
+++ b/docs/src/config/layout.md
@@ -0,0 +1,21 @@
+- 🏠 [home](https:/github.com/isabelroses/dotfiles/tree/main//home/) Where all home-manager configurations lie
+- 🖥️ [systems](https:/github.com/isabelroses/dotfiles/tree/main//systems/)
+  - ☀️ [Amaterasu](https:/github.com/isabelroses/dotfiles/tree/main//systems/amaterasu) My high-end gaming machine
+  - 🐉 [Hydra](https:/github.com/isabelroses/dotfiles/tree/main//systems/hydra/) A super mid spec laptop
+  - ⚸ [Lilith](https:/github.com/isabelroses/dotfiles/tree/main//systems/lilith/) A NixOS ISO image that can be quickly deployed and accessed via ssh
+  - ⚖️ [minerva](https:/github.com/isabelroses/dotfiles/tree/main//systems/minerva/) A server configuration for some of my infrastructure
+  - 𖤍 [Valkyrie](https:/github.com/isabelroses/dotfiles/tree/main//systems/valkyrie/) A WSL2 host, designed to be a development environment on Windows
+  - 💮 [Tatsumaki](https:/github.com/isabelroses/dotfiles/tree/main//systems/tatsumaki/) A MacBook Air, configured to last a whole day of university
+- 🧩 [parts](https:/github.com/isabelroses/dotfiles/tree/main//parts/) NixOS parts breaking down the complex configuration into smaller more manageable chunks
+  - 📚 [lib](https:/github.com/isabelroses/dotfiles/tree/main//parts/lib/) Useful repeated functions
+  - 🛠️ [templates](https:/github.com/isabelroses/dotfiles/tree/main//parts/templates/) Templates for setting up development environments
+  - 👾 [modules](https:/github.com/isabelroses/dotfiles/tree/main//parts/modules/) Exported modules for NixOS, home-manager and Nix Darwin
+- 🔌 [modules](https:/github.com/isabelroses/dotfiles/tree/main//modules/)
+  - [base](https:/github.com/isabelroses/dotfiles/tree/main//modules/base/) The base configuration settings, which are common between all systems
+  - [darwin](https:/github.com/isabelroses/dotfiles/tree/main//modules/darwin/) Pre-made modules for exclusively darwin systems
+  - [nixos](https:/github.com/isabelroses/dotfiles/tree/main//modules/nixos/) Pre cooked modules for exclusively nixos systems
+  - [iso](https:/github.com/isabelroses/dotfiles/tree/main//modules/iso/) Pre-configured modules prepared for making NixOS iso images
+  - [extra](https:/github.com/isabelroses/dotfiles/tree/main//modules/extra) Extra configuration modules, for home-manager and Nix Darwin and NixOS
+  - [profiles](https:/github.com/isabelroses/dotfiles/tree/main//modules/profiles/) Pre-made profiles for different system types
+    - [hardware](https:/github.com/isabelroses/dotfiles/tree/main/modules/profiles/hardware) Optimized settings for different devices (e.g., laptop, servers, desktop)
+    - [meta](https:/github.com/isabelroses/dotfiles/tree/main/modules/profiles/meta) Optimized configurations for different natures (e.g., headless, graphical)
diff --git a/docs/src/config/shortcuts.md b/docs/src/config/shortcuts.md
new file mode 100644
--- /dev/null
+++ b/docs/src/config/shortcuts.md
@@ -0,0 +1,12 @@
+| SKHD Shortcut                 | Hyprland Shortcut               | What it does               |
+| ----------------------------- | ------------------------------- | -------------------------- |
+| <kbd>CMD+RETURN</kbd>         | <kbd>SUPER+RETURN</kbd>         | open terminal              |
+|                               | <kbd>SUPER+B</kbd>              | open browser               |
+|                               | <kbd>SUPER+C</kbd>              | open editor                |
+|                               | <kbd>SUPER+O</kbd>              | open notes                 |
+|                               | <kbd>SUPER+E</kbd>              | open file manager          |
+| <kbd>CMD+Q</kbd>              | <kbd>SUPER+Q</kbd>              | quit                       |
+| <kbd>CMD+D</kbd>              | <kbd>SUPER+D</kbd>              | launcher                   |
+|                               | <kbd>SUPER+F</kbd>              | full screen                |
+| <kbd>CMD+CTRL+[number]</kbd>  | <kbd>SUPER+[number]</kbd>       | open workspace [number]    |
+| <kbd>CMD+SHIFT+[number]</kbd> | <kbd>SUPER+SHIFT+[number]</kbd> | move to workspace [number] |
diff --git a/docs/src/config/templates.md b/docs/src/config/templates.md
new file mode 100644
--- /dev/null
+++ b/docs/src/config/templates.md
@@ -0,0 +1,6 @@
+To use the templates there are two commands you can run, they are:
+
+- `nix flake init -t github:isabelroses/dotfiles#<template>` to initialize a new project with the template
+- `nix flake new -t github:isabelroses/dotfiles#<template> <out dir>` to create a new project in the specified directory
+
+For the full list of templates you can look in the [templates](https://github.com/isabelroses/dotfiles/tree/main/parts/templates/) directory or run `nix flake show github:isabelroses/dotfiles`.
diff --git a/docs/src/further-reading.md b/docs/src/further-reading.md
new file mode 100644
--- /dev/null
+++ b/docs/src/further-reading.md
@@ -0,0 +1,43 @@
+# Resources
+
+A collection of resources from people who just make good stuff.
+
+- [Xe's blog](https://xeiaso.net/blog/)
+- [The aux forum](https://forum.aux.computer/)
+- [Viper's Blog](https://ayats.org/)
+- [Nix Pills](https://nixos.org/guides/nix-pills/), this one might be a bit much if you don't care too much about the internals
+- [Solène's Blog](https://dataswamp.org/~solene)
+- [Jade Lovelace's blog](https://jade.fyi/)
+- [Astrid's blog](https://astrid.tech/t/nixos)
+- [nixpkgs news](https://nixpkgs.news/)
+- [nix.dev](https://nix.dev/)
+- [cafkafk's blog](https://cafkafk.dev/)
+- [zimbatm's blog](https://zimbatm.com/notes)
+- [my own blog](https://isabelroses.com/blog/tag/nix)
+- [official wiki](https://wiki.nixos.org/wiki/NixOS_Wiki)
+- [zero to nix](https://zero-to-nix.com/start)
+
+# Projects / Configurations
+
+These are some configuration or projects that I have taken inspiration from or find to be of a high quality that people should also consider reading.
+
+- [lovesegfault/nix-config](https://github.com/lovesegfault/nix-config)
+- [jakehamilton/config](https://github.com/jakehamilton/config)
+- [flake parts](https://flake.parts/)
+- [nixos-hardware](https://github.com/NixOS/nixos-hardware)
+- [getchoo/flake](https://github.com/getchoo/flake)
+- [uncenter/flake](https://github.com/uncenter/flake)
+
+# People
+
+Thanks to all these people otherwise this config and I would be lost.
+
+- [comfysage](https://github.com/comfysage), for making my day that bit brighter and occasionally putting me on your back
+- [getchoo](https://github.com/getchoo), for making catppucin/nix and helping a ton
+- [nullishamy](https://github.com/nullishamy), for tricking me into using NixOS
+- [nekowinston](https://github.com/nekowinston), for fixing half my problems
+- [jakehamilton](https://github.com/jakehamilton), for teaching me too much about modules
+- [nyxkrage](https://github.com/nyxkrage), for being there to answer my questions
+- [NotAShelf](https://github.com/notashelf), lots of valuable information
+- [Minion3665](https://github.com/Minion3665), for making me write better docs
+- [Thorn](https://git.avery.garden/thorn), picrewnix????
diff --git a/docs/src/misc/previews.md b/docs/src/misc/previews.md
new file mode 100644
--- /dev/null
+++ b/docs/src/misc/previews.md
@@ -0,0 +1,5 @@
+![Preview image](/images/main.png)
+![images/lightmode.png](/images/lightmode.png)
+![images/blur](/images/blur.png)
+![images/nvim](/images/nvim.png)
+![image of my flakes topology](/images/topology.png)
diff --git a/parts/packages/default.nix b/parts/packages/default.nix
--- a/parts/packages/default.nix
+++ b/parts/packages/default.nix
@@ -14,6 +14,8 @@ icat
           extract
           ;
 
+        docs = pkgs.callPackage ./docs.nix { };
+
         lix =
           (inputs'.lix.packages.default.override {
             # sometimes this builds from source and i hate it
diff --git a/parts/packages/docs.nix b/parts/packages/docs.nix
new file mode 100644
--- /dev/null
+++ b/parts/packages/docs.nix
@@ -0,0 +1,61 @@
+{
+  stdenvNoCC,
+  mdbook,
+  mdbook-alerts,
+  fetchurl,
+  simple-http-server,
+  writeShellApplication,
+  ...
+}:
+stdenvNoCC.mkDerivation (finalAttrs: {
+  name = "docs";
+
+  src = ../../docs;
+
+  nativeBuildInputs = [
+    mdbook
+    mdbook-alerts
+  ];
+
+  buildPhase = ''
+    runHook preBuild
+
+    mkdir -p theme
+    cp ${finalAttrs.passthru.catppuccin-mdbook} theme/catppuccin.css
+    cp ${finalAttrs.passthru.catppuccin-alerts} theme/catppuccin-alerts.css
+
+    mdbook build
+
+    runHook postBuild
+  '';
+
+  installPhase = ''
+    runHook preInstall
+
+    cp -r ./dist $out
+
+    runHook postInstall
+  '';
+
+  passthru = {
+    catppuccin-mdbook = fetchurl {
+      url = "https://github.com/catppuccin/mdBook/releases/download/v3.1.0/catppuccin.css";
+      sha256 = "04fyl5fl0q1sj0i7i5zmkj11gakyfpqmbbr82x8hyk3d5p089mr7";
+    };
+
+    catppuccin-alerts = fetchurl {
+      url = "https://github.com/catppuccin/mdBook/releases/latest/download/catppuccin-alerts.css";
+      sha256 = "1grbgvhg5sgqfryds22mhvb5sfn83zcga84wyqiy4bgl5wbawwsf";
+    };
+
+    serve = writeShellApplication {
+      name = "serve";
+
+      runtimeInputs = [ simple-http-server ];
+
+      text = ''
+        simple-http-server -i -- ${finalAttrs.finalPackage}
+      '';
+    };
+  };
+})