Changelog

All notable changes to Aquiis SimpleStart will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.2] - 2026-03-01

🏷️ AppImageHub Compliance Release

Aquiis SimpleStart v1.1.2 adds license metadata to the AppImage for AppImageHub catalog integration. This is a metadata-only enhancement with no functional changes.

Added

AppImageHub Integration

Embedded MIT license metadata in AppImage desktop file via electron.manifest.json configuration
- Added linux.desktop.entry.X-AppImage-Payload-License: MIT configuration
- Enables automated license detection by AppImageHub CI validation
- Desktop file inside AppImage now contains X-AppImage-Payload-License=MIT field
Updated appdata.xml with v1.1.2 release information

Technical Details

Application Version: 1.1.2
Database Schema: v1.1.0 (unchanged from v1.1.1)
Assembly Version: 1.1.2.0
File Version: 1.1.2.0
Informational Version: 1.1.2
Release Type: Patch (metadata enhancement only)

Changed

electron.manifest.json: Added linux.desktop.entry configuration for custom desktop file fields
All project version files: Updated from 1.1.1 to 1.1.2 (electron.manifest.json, .csproj, appsettings.json, package.json)
Documentation: Updated all version references to 1.1.2

Upgrade Path

From v1.1.1: Drop-in replacement, no database migration required, no functional changes
From v1.1.0: Drop-in replacement, no database migration required
From v1.0.0: Automatic migration to v1.1.0 schema on first run, then v1.1.2 application starts

Platform Support

Linux: AppImage (x86_64) with embedded license metadata ✅
Windows: NSIS Installer and Portable (x64) - unchanged from v1.1.1

References

AppImageHub PR: #3688
Pattern Reference: Gryt Chat (successful desktop file license implementation)
electron-builder Desktop Entry: Documentation

Notes

This release focuses solely on AppImageHub catalog compliance by embedding license metadata in the desktop file. Users of v1.1.1 will not experience any functional differences. The version bump from v1.1.1 to v1.1.2 ensures clear distinction between AppImages with and without license metadata for distribution clarity.

[1.1.1] - 2026-02-28

🐛 Bug Fix & Enhancement Release

Aquiis SimpleStart v1.1.1 addresses critical UI bugs and completes Windows database encryption support. This is a patch release with no database schema changes.

Added

Windows Enhancements

Windows database encryption implementation using DPAPI (Data Protection API) for secure key storage
Windows installer deployment - switched from portable executable to proper installer with uninstall support, start menu shortcuts, and desktop icon

UI Improvements

Visual feedback during login - spinner and "Logging in..." text displayed during authentication
Login button disabled during authentication to prevent double-submission
Hidden Electron menu bar - Auto-hide menu bar for cleaner, more native desktop experience

Changed

Theme System Optimization

Optimized MutationObserver to only watch theme attributes on documentElement instead of entire document.body
- Previous behavior: Watched entire body with childList: true, subtree: true (triggered on every Blazor render)
- Current behavior: Only watches data-bs-theme and data-brand-theme attributes
- Impact: Prevents unnecessary reflow operations during navigation

Navigation Improvements

Added guard in OnLocationChanged to skip processing when URL unchanged
Prevents redundant theme re-application on repeated same-link clicks

Fixed

Theme Issues

Fixed brand theme flicker when clicking same NavLink repeatedly
- Issue: Clicking Dashboard (or any nav item) multiple times switched brand theme from Obsidian/Teal to Bootstrap light theme
- Root cause: MutationObserver firing on every NavLink re-render, triggering DOM reflow operations (document.documentElement.style.display = "none") that briefly reset CSS
- Solution: Optimized observer scope to only watch specific theme attributes + added OnLocationChanged guard to prevent redundant processing

Authentication Issues

Fixed login double-submit causing blank page redirect
- Issue: Rapid login button clicks caused concurrent authentication attempts, resulting in navigation to blank page
- Root cause: No submission guard preventing multiple PasswordSignInAsync calls
- Solution: Added isSubmitting flag with early return guard, button disabled during login, finally block ensures flag reset even on exceptions

Documentation

Cross-References

Added cross-references between README and Quick Start Guide
Added cross-references between README and Database Management Guide
Added cross-references between Database Management Guide and Compatibility Matrix
Improved documentation navigation flow for new users

Table Formatting

Fixed markdown table alignment in Database-Management-Guide.md for better readability

Technical Details

Application Version: 1.1.1
Database Schema Version: 1.1.0 (unchanged from v1.1.0)
Assembly Version: 1.1.1.0
Electron Package: 1.1.1
Files Changed: 5 (theme.js, Login.razor, NavMenu.razor, Database-Management-Guide.md, README.md)
Lines Changed: 79 insertions(+), 32 deletions(-)

Upgrade Notes

From v1.1.0: No database migration required (schema unchanged). Simply install new version.
From v1.0.0: Automatic migration to v1.1.0 schema will run first, then v1.1.1 application starts.
Windows Users: Uninstall portable version if present, then install new installer version.
Database Location: Unchanged - schema version remains 1.1.0.

Compatibility

Compatible with: Database schema v1.1.0
Upgrade path: v1.0.0 → v1.1.0 (auto-migration) → v1.1.1 (no migration)
Downgrade: Not recommended - use backup/restore instead

[1.0.0] - 2026-01-29

🎉 Initial Production Release

Aquiis SimpleStart v1.0.0 is the first production-ready release of our desktop property management application for landlords managing 1-9 residential properties.

Added

Property Management

Property profiles supporting up to 9 residential properties
Property photos and document attachments
Property status tracking (Available, Occupied, Under Renovation, Off-Market)
Property portfolio overview dashboard
Property-specific settings and customization

Tenant Management

Complete prospect-to-tenant lifecycle workflow
Prospective tenant profiles with 9 status transitions
Digital rental application system with online submission
Application screening workflow (background checks, credit checks)
Tenant conversion system with audit trail
Tenant profiles with contact information and emergency contacts
Multi-lease support (tenants can have multiple active leases)

Lease Management

Digital lease creation and management
Lease offer generation with expiration tracking (30-day validity)
E-signature workflow with full audit trail (IP address, timestamp, user agent)
Lease acceptance with security deposit collection
Multi-lease support per tenant
Security deposit investment pool with annual dividends
Dividend distribution system (pro-rated, tenant choice: credit or check)
Lease status tracking (Offered, Active, Declined, Terminated, Expired)
Automatic lease expiration notifications
Month-to-month rollover for unsigned lease offers

Financial Management

Automated rent invoice generation
Monthly recurring invoice support
Payment tracking with multiple payment methods
Late fee calculation after configurable grace period
Automatic late fee application via background service (daily at 2 AM)
Payment history and tracking
Financial reports (income summary, payment history)
Security deposit dividend calculations and distribution

Maintenance & Inspections

Maintenance request tracking and management
Vendor assignment and coordination
Comprehensive 26-item inspection checklist (5 categories: Exterior, Interior, Kitchen, Bathroom, Systems)
Move-in, Move-out, and Routine inspection types
Scheduled routine inspections with automatic reminders
PDF inspection report generation with QuestPDF
Photo attachments for inspection items
Inspection history and tracking

Calendar & Scheduling

Calendar event management system
Event types: Tours, Inspections, Maintenance, Payments, Lease Events, Other
Automated recurring event creation
Event reminders and notifications
Property-specific event filtering
Timeline view of upcoming events

Notifications & Communication

Multi-channel notification system (in-app, email, SMS)
Graceful degradation if external services unavailable
Notification preferences per user
Email notifications via SendGrid integration
SMS notifications via Twilio integration
Toast notifications for in-app feedback
Automatic notifications for: late fees, lease expiration, inspection reminders, payment confirmations

Database Management

SQLite file-based database (no server required)
Automatic schema migration system
Manual backup creation (on-demand)
Scheduled automatic backups (daily/weekly/monthly at 2 AM)
Staged restore with preview functionality
Full restore with automatic application restart
Database health checks (startup, hourly, before backup)
Database optimization (VACUUM/ANALYZE)
Database reset with safety confirmations
Backup retention management
External backup support (cloud sync, USB)
3-2-1 backup strategy recommended

Background Automation

Scheduled task service running daily at 2 AM
Automatic late fee application after grace period
Lease expiration monitoring and notifications
Security deposit dividend calculation and distribution
Routine inspection scheduling
Database cleanup and maintenance
Cache refresh and optimization

User Management

ASP.NET Core Identity integration
Three user roles: Administrator, PropertyManager, Tenant
Role-based access control (RBAC)
User account creation and management
Password policies and security
Account lockout protection
Session timeout after 18 minutes of inactivity
Session timeout modal with extend/logout options
User limit: 3 users maximum (1 system + 2 login users)

Reports & Analytics

Financial reports (income summary, payment history)
Property portfolio overview
Maintenance summary reports
Inspection history reports
Payment tracking reports
PDF report generation with QuestPDF
Export capabilities for reports

Desktop Application Features

ElectronNET desktop wrapper for native experience
Cross-platform support (Linux and Windows)
Offline-capable database (SQLite)
Native file system integration
System tray integration
Application auto-updates (future)
Single-instance enforcement

Documentation

Comprehensive Release Notes (48 sections)
Quick Start Guide (15-minute tutorial with 9 steps)
Database Management Guide (10 chapters: backup, restore, troubleshooting)
System Requirements documentation
Installation guides (Linux AppImage/deb, Windows NSIS/portable)
FAQ sections (15+ questions per guide)
Troubleshooting guides (5+ scenarios per guide)

Known Limitations

Aquiis SimpleStart is intentionally designed with the following constraints for simplified workflows and performance:

Limitation	Value	Reason
Properties	Maximum 9	Simplified workflows
Users	Maximum 3 (1 system + 2 login)	Simplified access control
Organizations	1 only	Desktop application scope
File uploads	10MB per file	Performance management
Calendar	Uses legacy service	Technical debt (refactor v1.1)

Need more capacity? Watch for Aquiis Professional (v2.0.0, 2027) with unlimited properties and multi-organization support.

Technical Specifications

Framework: ASP.NET Core 10.0 + Blazor Server
Desktop: ElectronNET 23.6.2
Database: SQLite (Microsoft.EntityFrameworkCore.Sqlite 10.0.1)
PDF Generation: QuestPDF 2025.12.1
Email: SendGrid 9.29.3
SMS: Twilio 7.14.0
UI: Bootstrap 5.3, Material Design Icons
Architecture: Clean Architecture with service layer pattern
Test Coverage: 303 unit tests passing

System Requirements

Minimum:

OS: Linux (Ubuntu 20.04+, Debian 11+) or Windows 10/11 (64-bit)
CPU: 2-core, 1.5 GHz
RAM: 2 GB
Disk: 500 MB

Recommended:

CPU: 4-core, 2.5 GHz
RAM: 4 GB
Disk: 1 GB
Display: 1920x1080