Skip to content

xnodeoncode/Aquiis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

163 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Aquiis SimpleStart

Modern Property Management for Landlords

Version License .NET Platform


Aquiis SimpleStart is a standalone desktop application designed for landlords managing 1-9 residential rental properties. Built with ASP.NET Core 10 and Blazor Server, wrapped in Electron for native desktop experience, it provides professional-grade property management features without the complexity or subscription costs of enterprise solutions.

Perfect for:

  • Independent landlords with a few properties
  • Property owners who self-manage their rentals
  • New landlords starting their portfolio
  • Anyone seeking affordable, easy-to-use property management software

✨ Key Features

Property Management

  • πŸ“‹ Manage up to 9 residential properties
  • 🏑 Property profiles with photos and documents
  • πŸ” Track property status (Available, Occupied, Under Renovation)
  • πŸ“Š Property portfolio overview and analytics

Tenant Management

  • πŸ‘₯ Complete prospect-to-tenant journey
  • πŸ“ Digital rental applications with screening
  • βœ… Application approval workflow
  • 🀝 Tenant profiles with contact information

Lease Management

  • πŸ“„ Digital lease creation and management
  • ✍️ Lease offers with acceptance tracking
  • πŸ”„ Multi-lease support (tenants can have multiple active leases)
  • πŸ’° Security deposit investment tracking with annual dividends

Financial Management

  • 🧾 Automated rent invoice generation
  • πŸ’³ Payment tracking by multiple methods
  • ⏰ Automatic late fee application after grace period
  • πŸ“ˆ Financial reports and payment history

Maintenance & Inspections

  • πŸ”§ Maintenance request tracking with vendor assignment
  • βœ… Comprehensive 26-item inspection checklist
  • πŸ“… Scheduled routine inspections
  • πŸ“„ PDF inspection reports with QuestPDF

Notifications & Automation

  • πŸ”” In-app, email, and SMS notifications
  • ⏰ Automatic late fees and lease expiration warnings
  • πŸ“… Background tasks for scheduling and cleanup
  • 🎯 Configurable notification preferences

Database Management

  • πŸ’Ύ SQLite file-based database (no server required)
  • πŸ”„ Automatic schema migrations
  • πŸ“¦ Manual and scheduled backups
  • ♻️ Staged restore with preview

οΏ½ Download

Latest Release: v1.0.0

Download for Linux Download for Windows

All Downloads: View v1.0.0 Release


πŸš€ Quick Start

Installation

Linux (AppImage)

# Download from releases page or use wget
wget https://github.com/xnodeoncode/Aquiis/releases/download/v1.0.0/AquiisPropertyManagement-1.0.0.AppImage

# Make executable
chmod +x AquiisPropertyManagement-1.0.0.AppImage

# Option 1: Desktop integration (recommended)
wget https://github.com/xnodeoncode/Aquiis/releases/download/v1.0.0/install-desktop-integration.sh
chmod +x install-desktop-integration.sh
./install-desktop-integration.sh AquiisPropertyManagement-1.0.0.AppImage

# Option 2: Run directly
./AquiisPropertyManagement-1.0.0.AppImage

Windows (Portable Executable)

  1. Download AquiisPropertyManagement 1.0.0.exe from releases page
  2. Move to permanent location (e.g., C:\Program Files\Aquiis\)
    • ⚠️ Database and settings are stored relative to the .exe location
  3. Double-click to run
  4. First launch: Windows SmartScreen warning is expected (app is unsigned)
    • Click "More info" β†’ "Run anyway"
    • Code signing planned for v1.1.0

Verify Download (Optional)

# Download checksums
wget https://github.com/xnodeoncode/Aquiis/releases/download/v1.0.0/checksums.txt

# Linux
sha256sum -c checksums.txt

# Windows PowerShell
Get-FileHash "AquiisPropertyManagement 1.0.0.exe" -Algorithm SHA256

First Run

  1. New Setup Wizard guides you through initial configuration
  2. Create your organization (business name and contact info)
  3. Register your first user account
  4. Start managing properties!

15-Minute Tutorial

Follow our Quick Start Guide to:

  • Add your first property
  • Add a tenant
  • Create a lease
  • Generate an invoice
  • Record a payment
  • Schedule an inspection

πŸ“‹ System Requirements

Minimum Requirements

  • 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

Software

  • All dependencies bundled (no installation required)
  • Optional: SendGrid (email) and Twilio (SMS) for notifications

πŸ“š Documentation

User Documentation

Developer Documentation


⚠️ Known Limitations

SimpleStart is with intentional constraints:

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

Need more capacity? Watch for Aquiis Professional (coming 2026) with unlimited properties and multi-organization support.


πŸ› οΈ Technology Stack

  • 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

πŸ—οΈ Project Structure

Aquiis/
β”œβ”€β”€ 0-Aquiis.Core/              # Domain entities and interfaces
β”œβ”€β”€ 1-Aquiis.Infrastructure/    # Data access and external services
β”œβ”€β”€ 2-Aquiis.Application/       # Business logic and services
β”œβ”€β”€ 3-Aquiis.UI.Shared/         # Shared UI components (SimpleStart + Professional)
β”œβ”€β”€ 4-Aquiis.SimpleStart/       # SimpleStart desktop application
β”œβ”€β”€ 5-Aquiis.Professional/      # Professional web application (future)
└── 6-Tests/                    # Unit and integration tests

πŸ§ͺ Testing

Test Suite:

  • βœ… 303 unit tests passing
  • βœ… Application layer: 243 tests (services, workflows, business logic)
  • βœ… UI.Shared components: 47 tests (layout, notifications, common components)
  • βœ… Core validation: 13 tests (utilities, attributes)

Integration tests require running applications and are validated during UAT.

Run tests:

dotnet test Aquiis.sln

🀝 Contributing

We welcome contributions! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-feature-name
  3. Read copilot-instructions.md for architecture guidelines
  4. Make your changes following the coding standards
  5. Write tests for new features
  6. Submit a pull request

Development Workflow

Branch Strategy:

main (protected, production-ready)
  ↑ Pull Request
development (integration testing)
  ↑ Direct merge
feature/your-feature-name

Build and run:

# Build
dotnet build Aquiis.sln

# Run SimpleStart
cd 4-Aquiis.SimpleStart
dotnet run

# Or use hot reload
dotnet watch

πŸ“Š Versioning

We use Semantic Versioning:

  • MAJOR version (X.0.0): Breaking changes, database schema updates
  • MINOR version (0.X.0): New features, UI changes (backward compatible)
  • PATCH version (0.0.X): Bug fixes, minor updates

Current version: 1.0.0 (Initial production release)


πŸ—ΊοΈ Roadmap

v1.1.0 (Q2 2026)

  • 🎯 Tenant portal for online payment and maintenance requests
  • 🎯 Calendar refactoring (remove legacy service dependencies)
  • 🎯 Enhanced reporting and customization
  • 🎯 Mobile companion app (view-only)

v1.2.0 (Q3 2026)

  • πŸ’³ Online rent payment processing (Stripe integration)
  • πŸ“Š Advanced analytics and forecasting

v2.0.0 (2027) - Aquiis Professional

  • 🏒 Unlimited properties
  • πŸ‘₯ Multi-organization support
  • 🌐 Web-based deployment
  • πŸ“± Full mobile app

πŸ“œ License

Copyright Β© 2026 CIS Guru. All rights reserved.

Licensed under the MIT License - see LICENSE file for details.


πŸ“ž Support

Getting Help

Community

  • ⭐ Star this repository
  • 🍴 Fork and contribute
  • πŸ’¬ Join discussions
  • πŸ“’ Share feedback

πŸ™ Acknowledgments

Built with:

  • ASP.NET Core team for the amazing framework
  • Electron.NET team for desktop integration
  • QuestPDF team for PDF generation
  • SendGrid and Twilio for notification services
  • GitHub Copilot for AI-assisted development

Special thanks:

  • All beta testers and early adopters
  • Open source community contributors
  • Everyone who provided feedback and suggestions

🎊 Status

v1.0.0 - General Availability πŸŽ‰

  • βœ… 95.75% Production Ready
  • βœ… 303 tests passing
  • βœ… CI/CD pipeline complete
  • βœ… Documentation complete
  • πŸš€ Ready for production use!

Made with ❀️ for independent landlords everywhere

Happy property managing! 🏠

About

Property Management Application

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •