ShareX Workflow and Versioning
Scope
This file is the single source of truth for Git and versioning rules that involve:
- Commit and push workflow
- Commit message format
- Version bump behavior
Directory.Build.propsupdates
This supersedes the retired docs/development/RELEASE_PROCESS.md.
Version Source Of Truth
- Treat the root
Directory.Build.propsfile as the working XerahS app version source of truth. - Before any versioned XerahS commit, compare the root version with the highest existing XerahS git tag.
- If the root version is not strictly greater than the latest tag, bump the root version first so the branch carries the next unreleased version.
- Never set version numbers in individual
.csprojfiles. - When bumping version, update every tracked
Directory.Build.propsin the repository that intentionally carries the XerahS app version so values match. - Derived release metadata files, such as
build/windows/chocolatey/xerahs.nuspec, must be synchronized from the root version during release automation. - Tagged releases also generate and smoke-test the Chocolatey
.nupkg, so release metadata underbuild/windows/chocolatey/must stay automation-friendly.
More from sharex/xerahs
design-ui-window
Redesigns or normalises any XerahS Avalonia .axaml page, dialog, or tool window to consistent app quality. Enforces layout, spacing, theming, surfaces, buttons, scrollbars, accessibility, and visual hierarchy. Only changes visuals, layout, and styles; never business logic, bindings, or public view-model API. Reusable by updating target_view_path.
71sharex core standards
License headers, build configuration rules, dependency version guidance, and general coding standards for XerahS
61changelog management
Rules and workflows for updating CHANGELOG.md, including version grouping, consolidation, and commit handling.
59sharex feature specifications
Detailed specifications for Uploader Plugin System and Annotation Subsystem features
58sharex architecture and porting
Platform abstraction rules, porting guidelines, and architecture standards for XerahS
57avalonia-api
Comprehensive reference for Avalonia UI framework including XAML syntax, controls, data binding, MVVM patterns, styling, custom controls, layout system, responsive layout, navigation, and best practices. Covers CommunityToolkit.Mvvm integration, compiled bindings, dependency properties, attached properties, control templates, container queries, and cross-platform development patterns.
38