↓Skip to main content

ErrandWiz

Project Overview #

Timeline: December 2024 - Present (In Development)

ErrandWiz is a mobile SaaS platform built with Flutter, demonstrating modern mobile architecture with offline-first database synchronization and modular design. Currently in pre-launch phase with coming-soon page live at www.errandwiz.com.

Status: Pre-launch development with core infrastructure complete

Technical Architecture #

Core Technology Stack #

  • Framework: Flutter with Dart
  • State Management: Riverpod for reactive state
  • Navigation: GoRouter with type-safe routing
  • Local Database: Drift ORM for SQLite
  • Database Sync: PowerSync for offline-first synchronization
  • Backend: Supabase for cloud database and authentication
  • Monorepo: Melos for multi-package workspace management
  • Billing: Credit-based subscription system

DevOps & Infrastructure #

  • Container Orchestration: Kubernetes for cloud deployment
  • CI/CD: GitHub with self-hosted runners for build automation
  • Infrastructure as Code: Pulumi for declarative infrastructure management
  • Code Quality: CodeCov for test coverage tracking
  • Version Control: GitHub with branch protection and automated workflows

Architecture Principles #

Clean Architecture #

  • Layered structure with clear separation of concerns
  • Repository pattern for data access abstraction
  • Event bus for decoupled cross-feature communication
  • Modular packages with enforced boundaries

Offline-First Database Sync #

SQLite Local ↔ PowerSync ↔ Supabase Cloud
(Drift ORM)    (Sync)       (Backend)

Benefits:

  • Full offline functionality
  • Automatic bidirectional sync when online
  • Real-time updates across devices
  • Optimistic UI with eventual consistency

State Management #

Riverpod Architecture:

  • Compile-time safe dependency injection
  • Reactive providers with automatic rebuilds
  • Async state handling with loading/error states
  • Family providers for parameterized data

Billing System #

Credit-Based Model:

  • Free tier with 30-day trial
  • Subscription tiers (Basic, Premium)
  • Usage tracking and credit consumption
  • Automated billing through backend integration

Key Technical Achievements #

1. Offline-First Architecture #

  • Full offline functionality with local SQLite database
  • Automatic bidirectional sync via PowerSync
  • Real-time updates across devices
  • Conflict resolution built into sync layer

2. Clean Architecture at Scale #

  • Strict layer separation for maintainability
  • Repository pattern with clean interfaces
  • Event-driven communication prevents tight coupling
  • Modular structure enables independent feature development

3. Production-Ready Billing #

  • Credit-based system with subscription tiers
  • Automated usage tracking
  • Subscription lifecycle management
  • App Store payment integration

Technologies Summary #

Mobile: Flutter (cross-platform) Architecture: Clean Architecture, Riverpod State Management Data: Drift ORM, PowerSync Sync, Supabase Backend DevOps: Kubernetes, Self-Hosted GitHub Runners, Pulumi IaC, CodeCov Tooling: Melos Monorepo, GitHub, Automated Testing

Current Status #

Development Phase: Pre-launch with core infrastructure complete

  • ✅ Offline-first database sync operational
  • ✅ Clean Architecture patterns established
  • ✅ Billing system integrated
  • ✅ Authentication complete
  • 🚧 Final testing in progress
  • 🚧 App Store submission preparation

Marketing Website: www.errandwiz.com (coming-soon page)

Technical Achievement: Enterprise-scale Flutter architecture with offline-first capabilities and production-ready SaaS infrastructure.