Skip to content

xnodeoncode/Aquiis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

181 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 & Security

  • πŸ’Ύ SQLite file-based database (no server required)
  • πŸ”’ NEW: Database encryption at rest (SQLCipher AES-256)
  • πŸ”‘ NEW: OS keychain integration for password management
  • πŸ”„ Automatic schema migrations
  • πŸ“¦ Manual and scheduled backups
  • ♻️ Staged restore with preview
  • πŸ” Content Security Policy (CSP) headers for web security

οΏ½ Download

Latest Release: v1.1.0

Download for Linux Download for Windows

All Downloads: View v1.1.0 Release


πŸš€ Quick Start

Installation

Linux (AppImage)

# Download from releases page or use wget
wget https://github.com/xnodeoncode/Aquiis/releases/download/v1.1.0/Aquiis-1.1.0-x86_64.AppImage

# Make executable
chmod +x Aquiis-1.1.0-x86_64.AppImage

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

# Option 2: Run directly
./Aquiis-1.1.0-x86_64.AppImage

Windows (Installer or Portable)

Option A: Installer (Recommended)

  1. Download Aquiis-1.1.0-x64-Setup.exe from releases page
  2. Run installer and follow the setup wizard
  3. Launch from Start Menu or Desktop shortcut

Option B: Portable Executable

  1. Download Aquiis-1.1.0-x64-Portable.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

Note: Windows SmartScreen warning may appear (app is unsigned). Click "More info" β†’ "Run anyway". Code signing planned for future release.

Verify Download (Optional)

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

# Linux
sha256sum -c checksums.txt

# Windows PowerShell
Get-FileHash "Aquiis-1.1.0-x64-Setup.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

Universal Linux Support:

Aquiis is distributed as an AppImage, which runs on all major Linux distributionsβ€”including Ubuntu, Debian, Fedora, RedHat, Arch, openSUSE, and more. No installation required: just download, make executable, and run.

Windows Portable Version:

Aquiis is available as a portable Windows executable (.exe). No installation requiredβ€”just download, extract, and run. All application data is stored locally in the same folder, making it easy to use Aquiis from a USB drive or move between systems.

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.1.0 (Security and schema enhancement release) Database version: 1.1.0


πŸ—ΊοΈ Roadmap

v1.1.0 (Released February 2026) βœ…

  • βœ… Database encryption at rest (SQLCipher AES-256)
  • βœ… OS keychain integration (Linux)
  • βœ… Sample data management (IsSampleData flag)
  • βœ… Multi-tenant index fixes
  • βœ… Content Security Policy headers
  • βœ… Database schema v1.1.0 with automatic migrations

v1.2.0 (Q2 2026)

  • 🎯 Windows/macOS keychain integration
  • 🎯 Rate limiting for login endpoints
  • 🎯 Antiforgery tokens in all forms
  • 🎯 Code signing for Windows
  • 🎯 Calendar refactoring

v1.3.0 (Q3 2026)

  • 🎯 Tenant portal for online payment and maintenance requests
  • 🎯 Enhanced reporting and customization
  • πŸ’³ 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.1.0 - Security & Schema Enhancement Release πŸŽ‰

  • βœ… Production Ready
  • βœ… 303 tests passing
  • βœ… Database encryption at rest
  • βœ… CI/CD pipeline complete
  • βœ… Documentation complete
  • πŸ”’ Enterprise-grade security features
  • πŸš€ Ready for production use!

Made with ❀️ for independent landlords everywhere

Happy property managing! 🏠

About

Property Management Application

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •