Skip to content
BCLS

Major

Source: TEMPLATES/major.md

<!--
BCLS template — MAJOR release (vN.0.0).
Replace every <PLACEHOLDER>. Delete comments before publishing.
GitHub release title: <N.0.0 - <Hook subtitle>>   e.g. "4.0.0 - The Biggest Update Yet!"
Tag: v<N.0.0>


Major releases add a hero block (Welcome / Why now / Size diff / Breaking changes).
Hero persistence (§8.2.1): copy the hero block UNCHANGED into every vN.0.x patch body until vN.1.0 ships.
-->


# ⬇️ Downloads


<!--
Replace placeholders:
  <ORG>          GitHub user/org (e.g. BurntToasters)
  <APP>          GitHub repo name + asset filename prefix (e.g. IYERIS)
  <TAG>          Release tag including the leading v (e.g. v<N.0.0>)
  <MS_STORE_ID>  Microsoft Store listing id; remove the badge cell if not on the Store
Drop unsupported cells/rows. Comment out arch links you haven't built yet.
See STANDARD.md §3 for the canonical pattern.
-->


| <img height="20" src="https://raw.githubusercontent.com/BurntToasters/bcls/main/media/windows.png" /> Windows | <img height="20" src="https://raw.githubusercontent.com/BurntToasters/bcls/main/media/mac.png" /> macOS | <img height="20" src="https://raw.githubusercontent.com/BurntToasters/bcls/main/media/linux.png" /> Linux |
| :--- | :--- | :--- |
| **EXE:** [x64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Win-x64.exe) / [arm64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Win-arm64.exe) | **[Universal DMG](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-MacOS-universal.dmg)** | **AppImage:** [x64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-x86_64.AppImage) <!-- / [arm64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-arm64.AppImage) --> |
| <div align="center"><a href="https://apps.microsoft.com/detail/<MS_STORE_ID>?referrer=appbadge&mode=full"><img src="https://get.microsoft.com/images/en-us%20light.svg" width="150"/></a></div> | **[Universal ZIP](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-MacOS-universal.zip)** | **DEB:** [x64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-amd64.deb) <!-- / [arm64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-arm64.deb) --> |
| *See MSI note below* | | **RPM:** [x64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-x86_64.rpm) <!-- / [arm64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-aarch64.rpm) --> |
| | | **Flatpak:** [x64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-x86_64.flatpak) <!-- / [arm64](https://github.com/<ORG>/<APP>/releases/download/<TAG>/<APP>-Linux-aarch64.flatpak) --> |


> [!IMPORTANT]
> The `.sig` files in this repo are NOT normal gpg signatures — they are for Tauri V2's
> updater to verify the integrity of updates before downloading and installing.
>
> The `.asc` files are my normal GPG signatures which you can verify using my GPG Public
> Key: https://tuxedo.rosie.run/GPG/BurntToasters_0xF2FBC20F_public.asc


### ℹ️ Enjoying <APP>? Consider [❤️ Supporting Me! ❤️](https://rosie.run/support)


# Welcome to <APP> v<N>!!!


<Optional one-line hook, e.g. "<N>.0... Already?! I hear you say. Yes, here we are.">


## Why are we already on <N>.0?


<Story / motivation. What pushed the version. Lessons learned along the way.
Mention sister projects that informed the work, if any.>


## App Size Difference


<Optional comparison block. Numbers + a percentage delta:>


<Old framework> exe x64: <X> MB vs <Y> MB with <New framework>.


- Yes you read that right, a staggering <Z>% decrease in file size not just for windows, but to ALL operating systems as well!


## Breaking Changes


<What users must do (uninstall old version, re-import data, etc.).
Be specific and apologetic if migration is painful.>


## <Platform-specific caveats>


<e.g., "Linux arm64:" missing-arch explanation, or "Windows: WebView2 requirement", etc.>


## Changes in `v<N.0.0>:`


### Welcome to <APP> v<N>!


<Optional intro paragraph.>


- **NEW - <Feature>:** <Description.>
  - <Optional sub-bullet.>
- **NEW - <Feature>:** <Description.>
- **<Category>:** <Description.>
- **Misc:** <Catch-all summary line for everything else.>
- **PKG:** Updated packages.


### FULL CHANGELOG:


[Click here to see the full change-log for v<N>!](<URL>)


### MSI Installer Support (MSI builds are NOT provided for betas)


> [!IMPORTANT]
> **Enterprise Users:** We support Windows X64/ARM64 `.MSI` installers for MDM/AD deployment.
>
> - `.MSI` installers do NOT support auto-updates. You must deploy the new MSI manually.
> - These are strictly for enterprise management; standard users should use the EXE above.
> - Files available in the "Assets" dropdown below.


## ℹ️ Release Info


- **GPG Signed:** My public key is attached to every release to ensure authenticity.
- **GPG Key:** You can get my public GPG key here: https://tuxedo.rosie.run/GPG/BurntToasters_0xF2FBC20F_public.asc
- **Code Signing:** macOS releases are fully signed. Windows releases are not signed by an org, but
  are signed by my GPG signature (same with Linux).
- **Legacy Binaries:** Separate x64/arm64 Windows binaries are deprecated in favor of the Universal
  installer. They are still listed in the downloads section, but the universal installer is recommended
  for simplicity.