lxcafe Repository

Linux Mint post-installation scripts.

Structure

• post_installation_script/ - Main post-installation scripts for Linux Mint XFCE
• post_installation_script_test/ - Docker based testing environment for script development
• .agents/ - Agent instructions for AI-assisted development

See individual README files in each directory for detailed information on usage and development.

Test post installation script

To test the full functionality of post-installation script in a safe, isolated environment, use VirtualBox or similar virtualization software to create a virtual machine with Linux Mint XFCE. Then, copy the script to the virtual machine and run it there. This allows you to test the script without affecting your main system. You can also make use of snapshot feature of the virtualization software to easily revert to a clean state after testing, e.g. state directly after Linux Mint installation, before running the post-installation script. This way you can test the script multiple times without needing to reinstall Linux Mint each time.

Release Process

This project uses a two-step release process.

Versioning

• Version is stored in VERSION file (format: v0, v1, v2, ...)
• Major version increments only
• Script version stored in SCRIPT_VERSION variable

Step 1: Prepare Release

• Make sure you are on main branch with no local changes. Script will abort otherwise Run from repository root:

./01_prepare_release.sh

The script will:

• Update VERSION file and SCRIPT_VERSION in the script
• Create a release branch (e.g., release/v1)
• Push the release branch

After step 1 (manual)

• Create and merge PR from release branch to main

Step 2: Finalize Release (After PR Merged)

Run from repository root:

./02_finalise_release.sh

The script will:

• Create and push tag for release version to main

After step 2 (manual)

• Create a release in gitea

Requirements

• Clean working tree (no uncommitted changes)
• Git remote configured (origin)