# 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:
```bash
./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:
```bash
./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)