Testing - ulises-jeremias/dotfiles GitHub Wiki

🧪 Dotfiles Testing Environment Guide

Whether you're looking to contribute to the Dotfiles project or simply want to preview how everything looks before applying it to your system — we've got you covered with dedicated testing environments.

[!TIP] The testing setup allows you to experiment safely without affecting your real configuration. It’s a perfect playground for customizing themes, scripts, and behaviors.

🚀 Why Use the Testing Environment?

🧰 Preview your desktop layout and tool behavior
🔧 Tweak configs and see changes instantly
🤝 Contribute improvements with confidence
🧼 Avoid breaking your daily setup during experimentation

📖 How to Get Started

To learn how to set up the test environments, check out the official Testing Docs.

These docs include:

Environment requirements
Setup steps (VM or container)
How to apply dotfiles without affecting your main system

🔁 What Can You Test?

You can try out:

🪟 Window managers (Openbox, XFCE4, i3)
🎨 Themes (Rofi, Polybar, Zsh prompt)
🧩 Modules and utilities
🧪 Custom scripts or aliases
🛡️ Security configurations and defaults

🔄 Use this environment as a sandbox — test safely and iterate freely.

🧠 Tips for Effective Testing

Use a virtual machine or container for complete isolation
Snapshot your test environment before big changes
Commit working test configs to a feature branch before merging
Use chezmoi apply --dry-run to simulate changes before applying

🆘 Need Help?

Contributing or customizing just got easier. Jump into the testing environment, play around, and see how everything fits your workflow — worry-free!