Repo: professionalize structure, docs, and release standards

Author: Awetspoon

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,8 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Discussions
-    url: https://github.com/Awetspoon/Photo-Cutter/discussions
-    about: Ask questions and share workflows with the community.
+  - name: Security report
+    url: https://github.com/Awetspoon/Photo-Cutter/security/policy
+    about: Report vulnerabilities through the security policy process.
+  - name: Releases
+    url: https://github.com/Awetspoon/Photo-Cutter/releases
+    about: Download the latest app release.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+## Summary
+
+Describe the change and why it is needed.
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] UI/UX change
+- [ ] Documentation
+- [ ] Build/CI/release
+
+## Verification
+
+- [ ] `dotnet build .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj -c Release` passes
+- [ ] Manual run tested
+- [ ] Screenshots attached (if UI changed)
+
+## Checklist
+
+- [ ] I kept changes focused
+- [ ] I updated docs if needed
+- [ ] I did not commit generated binaries/build output

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: "nuget"
+    directory: "/solution/ImageUiSlicer"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5

.gitignore

@@ -44,3 +44,4 @@ Desktop.ini
 publish/
 artifacts/
 dist/
+release-assets/

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on Keep a Changelog and this project follows Semantic Versioning.
+
+## [Unreleased]
+
+### Added
+- Professional GitHub workflows for CI and release publishing
+- Public project documentation and community templates
+
+### Changed
+- Release pipeline now publishes a single executable asset: `PhotoCutter.exe`
+- Repository structure cleaned for a public app-facing layout
+
+## [1.0.1] - 2026-03-11
+
+### Changed
+- Release pipeline updated to upload only `PhotoCutter.exe`
+
+## [1.0.0] - 2026-03-11
+
+### Added
+- Initial public release
+- Core cutout workflow with select/lasso/polygon/shapes
+- Saved shape reuse, gallery, inspector, and export pipeline

CODE_OF_CONDUCT.md

@@ -0,0 +1,29 @@
+# Code of Conduct
+
+## Our commitment
+
+We are committed to making participation in this project a respectful, harassment-free experience for everyone.
+
+## Expected behavior
+
+- Be respectful and constructive.
+- Assume positive intent.
+- Focus feedback on code and behavior, not people.
+- Help keep discussions welcoming and practical.
+
+## Unacceptable behavior
+
+- Harassment, insults, or personal attacks
+- Discriminatory or exclusionary language
+- Deliberate intimidation or trolling
+- Publishing private information without consent
+
+## Enforcement
+
+Project maintainers may remove, edit, or reject comments, commits, issues, and pull requests that violate this Code of Conduct.
+
+## Reporting
+
+Report concerns privately to:
+
+- `mratcliff1995@gmail.com`

CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to Photo Cutter
+
+Thanks for improving Photo Cutter.
+
+## Development setup
+
+1. Install .NET SDK 8.x.
+2. Restore packages:
+   ```powershell
+   dotnet restore .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj
+   ```
+3. Run locally:
+   ```powershell
+   dotnet run --project .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj
+   ```
+
+## Pull request guidelines
+
+- Keep changes focused and small.
+- Preserve existing behavior unless the change is intentional and documented.
+- Include UI screenshots when changing visuals.
+- Update docs for any user-facing workflow changes.
+- Ensure build passes before pushing:
+  ```powershell
+  dotnet build .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj -c Release
+  ```
+
+## Commit style
+
+Use clear commit messages, for example:
+
+- `UI: fix shape toolbar overlap`
+- `Export: keep single-file release output`
+- `Docs: update release instructions`
+
+## Release process
+
+See [RELEASE.md](RELEASE.md).

README.md

@@ -5,37 +5,39 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/Platform-Windows%2010%2F11-0078D6)](https://github.com/Awetspoon/Photo-Cutter/releases/latest)
 
-Photo Cutter is a Windows desktop app for turning full mockups and screenshots into clean transparent PNG cutouts for app, UI, and game asset workflows.
+Windows desktop app for cutting transparent PNG assets from UI mockups and screenshots.
+
+![Photo Cutter Wordmark](brand/ImageUiSlicer_Wordmark_Transparent.png)
 
 ## Download
 
-- Latest release: [Download Photo Cutter](https://github.com/Awetspoon/Photo-Cutter/releases/latest)
-- Single-file download: `PhotoCutter.exe`
+- Latest release: [PhotoCutter.exe](https://github.com/Awetspoon/Photo-Cutter/releases/latest)
+- Distribution format: single-file Windows executable (`PhotoCutter.exe`)
 
-## Features
+## Core Features
 
-- Manual cutout tools: `Select`, `Lasso`, `Polygon`, `Shapes`
-- Reusable custom shapes (save, apply, duplicate, paste)
-- Brush refinement for active selection/cutout
+- Selection tools: `Select`, `Lasso`, `Polygon`, `Shapes`
+- Reusable custom shapes: save, apply, duplicate, paste
+- Brush refinement (`Brush +` / `Brush -`) on active selections and cutouts
 - Inspector preview with optional split compare
-- Cutout Gallery window for quick review
-- Export presets, naming controls, edge/outline options
-- Project save/load (`.iusproj`)
+- Cutout Gallery for fast visual review
+- Export presets, naming options, edge/outline controls
+- Project save/load support (`.iusproj`)
 
 ## Quick Start
 
 1. Open an image.
-2. Draw a selection using `Shapes`, `Lasso`, or `Polygon`.
+2. Draw a selection with `Shapes`, `Lasso`, or `Polygon`.
 3. Click `Commit Cutout`.
-4. Optional: save a cutout as a reusable shape.
+4. Optional: save selection as reusable shape.
 5. Export selected/all cutouts as PNG.
 
 ## Build From Source
 
 ### Requirements
 
 - Windows 10/11
-- .NET SDK `8.0.124` or compatible (see `global.json`)
+- .NET SDK 8.0.124+ (see `global.json`)
 
 ### Restore
 
@@ -49,39 +51,41 @@ dotnet restore .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj
 dotnet run --project .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj
 ```
 
-### Release Publish (single EXE)
+### Build
 
 ```powershell
-dotnet publish .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true /p:IncludeAllContentForSelfExtract=true /p:EnableCompressionInSingleFile=true
+dotnet build .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj -c Release
 ```
 
 ## Releasing
 
-- Tag format: `vX.Y.Z` (example: `v1.0.0`)
-- Pushing a version tag triggers GitHub Actions to:
-  - Build Release for Windows x64
-  - Produce single-file `PhotoCutter.exe`
-  - Upload release asset to GitHub Releases
+Tag and push a semantic version to publish a GitHub Release:
+
+```powershell
+git tag v1.0.2
+git push origin v1.0.2
+```
+
+Release workflow uploads one asset: `PhotoCutter.exe`.
 
-Full process: see [RELEASE.md](RELEASE.md).
+Detailed process: [RELEASE.md](RELEASE.md)
 
-## Folder Structure
+## Repository Structure
 
 ```text
 solution/ImageUiSlicer/      # WPF app source
-solution/ImageUiSlicer/Views # XAML views
-solution/ImageUiSlicer/ViewModels
-solution/ImageUiSlicer/Services
-solution/ImageUiSlicer/Models
-solution/ImageUiSlicer/CanvasEngine
 brand/                       # branding assets
 png/                         # icon ladder PNGs
-specs/                       # project/spec docs
+docs/specs/                  # product and technical specs
+docs/archive/                # archived legacy docs
 ```
 
-## Screenshots
+## Project Standards
 
-Add product screenshots or GIF demos in this section.
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Security: [SECURITY.md](SECURITY.md)
+- Changelog: [CHANGELOG.md](CHANGELOG.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
 
 ## License
 

RELEASE.md

@@ -1,34 +1,37 @@
 # Release Guide
 
-This repo is set up to publish Photo Cutter through GitHub Releases.
+This repository publishes Photo Cutter through GitHub Releases.
 
-## Automated release path (recommended)
+## Automated release flow (recommended)
+
+1. Ensure `main` contains your final release commit.
+2. Create and push a semantic version tag:
 
-1. Commit your changes on `main`.
-2. Create and push a version tag:
    ```powershell
-   git tag v1.0.0
-   git push origin v1.0.0
+   git tag v1.0.2
+   git push origin v1.0.2
    ```
+
 3. GitHub Actions workflow `Release Windows App` will:
-   - Build the app in Release mode
-   - Publish single-file `PhotoCutter.exe`
-   - Upload release assets to GitHub Releases
+   - Restore and build the project
+   - Publish a single-file Windows executable
+   - Create/update a GitHub Release
+   - Upload one asset: `PhotoCutter.exe`
 
-## Manual trigger path
+## Manual release flow
 
-1. Open Actions -> `Release Windows App`.
+1. Open GitHub Actions -> `Release Windows App`.
 2. Click `Run workflow`.
-3. Enter tag (for example `v1.0.1`).
-4. Run and wait for release assets to upload.
+3. Enter a valid version tag (example `v1.0.2`).
+4. Run workflow and confirm release asset upload.
 
 ## Local publish command
 
 ```powershell
 dotnet publish .\\solution\\ImageUiSlicer\\ImageUiSlicer.csproj -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true /p:IncludeAllContentForSelfExtract=true /p:EnableCompressionInSingleFile=true /p:DebugType=None /p:DebugSymbols=false
 ```
 
-Output binary:
+Published binary output:
 
 ```text
 solution/ImageUiSlicer/bin/Release/net8.0-windows/win-x64/publish/ImageUiSlicer.exe

SECURITY.md

@@ -0,0 +1,22 @@
+# Security Policy
+
+## Supported versions
+
+Photo Cutter currently supports the latest release on the `main` branch and latest tagged release.
+
+## Reporting a vulnerability
+
+Please do not open public issues for security vulnerabilities.
+
+Report privately by email:
+
+- `mratcliff1995@gmail.com`
+
+Include:
+
+- A short summary of the issue
+- Steps to reproduce
+- Potential impact
+- Optional proof-of-concept
+
+We will acknowledge receipt and provide an update as soon as possible.