minimaDots

Fresh Arch Install Requirement

This configuration is tailored for a FRESH INSTALL of VANILLA ARCH LINUX using the archinstall script with the Hyprland profile. We strongly advise against attempting this installation on derivative distributions (such as CachyOS, Manjaro, etc.) as package and configuration conflicts are highly likely. This includes packages you could install yourself, through Arch's repo, and a few AUR packages. This will install the chaotic AUR, the only AUR exclusive package that is installed, is the Noctalia bar itself.

🚀 Arch Installation Guide

Prerequisites

sudo pacman -S git

Step 1: Clone the Repository

Open your terminal and clone the repository using git:

git clone https://gitlab.com/minimalinux/minimaDots.git

Step 2: Change directory to the repo

cd ./minimaDots

Step 3: Make the install script executable

chmod +x ./install.sh

Step 4: Run the install script, YIPPE

sudo ./install.sh

Fedora Installation

We recommend using a fresh install of Fedora using the Fedora Everything install ISO with package selections seen in the above screenshot.

The Fedora installer will enable the following COPR repositories to provide additional packages needed for the setup:

• lionheartp/Hyprland
• leloubil/wl-clip-persist
• tofik/nwg-shell

We are also using Satty for screen annotations.

Credit goes to these developers for their excellent work.

To install on Fedora, follow these steps:

1. Install Git: bash sudo dnf install git -y

2. Clone the repository: bash git clone https://gitlab.com/minimalinux/minimaDots.git

3. Change into the project directory: bash cd minimaDots

4. Make the Fedora installer executable: bash chmod +x ./fedora_install.sh

5. Run the Fedora installer: bash sudo ./fedora_install.sh

Development Status

This script, is now released. It is no longer in beta state. This project originally started as a vibe coded project to see what we could get away with. It quickly turned into only being an outline, as A.I is too frustrating to deal with after more than 80 lines of code. The rest, is completely scripted by tonekneeo, and myself.

Lua Update

The Hyprland configuration now uses Lua-based. The old .conf-based structure is no longer used.

We have also switched over to Noctalia v5 beta.

What this does

This script turns a fresh Arch + Hyprland or Fedora setup into the minimaLinux desktop by installing required packages, dropping useless ones and adding preconfigured streamlined dotfiles.

Nvidia Users

NVIDIA Users: On line 32 of the startup.lua change local enable_nvidia_optional = false to local enable_nvidia_optional = true

The Fedora script will prompt the user and update the startup.lua as needed.

Credits

The primary application bar (noctalia) is based on the exceptional work by Noctalia. All credit for the bar's design and functionality goes to them:

noctalia-dev/noctalia-shell

Community

Join the Discord server: HERE

📦 What's Included?

This repository provides comprehensive configurations for a complete, customized Hyprland desktop environment.

⚙️ Customization Required

These dotfiles are provided strictly as a template. You must review and customize several files to align with your specific hardware, desired aesthetics, and system paths.

Additional Install Notes

For extra setup and troubleshooting details (including Arch ISO Wi-Fi setup before archinstall), see InstallNotes.md.

Note: The install.sh script handles package installation via your package manager and deploys the dotfiles. Any existing config files that would be overwritten are first backed up with a .bak.<timestamp> suffix in ~/.config, allowing uninstall.sh to restore them later.

🗑️ Uninstallation

If you need to revert the changes, navigate to the repository directory and run:

./uninstall.sh

This will restore any backed-up config files found in ~/.config to their previous state.

Note: Installed packages are not automatically removed. If you wish to uninstall them, you will need to do so manually via your package manager.