MichaelSoft Documentation
Technical reference and implementation guides for the MichaelSoft ecosystem. Our platform transforms fragmented, paper-based procurement into a unified, real-time digital workspace for small and medium businesses in Kenya and emerging markets.
Design Principles
Offline-Resilient UX
Kenya's internet connectivity is variable. The system uses optimistic UI updates — every mutation is reflected instantly in the interface, with background reconciliation against the server. If the network drops, the user keeps working. When it comes back, changes sync automatically.
Supplier-First Architecture
Unlike traditional procurement systems that treat suppliers as secondary metadata, this platform elevates suppliers to first-class entities with their own portal (via secure quotation links), delivery tracking, and price submission workflows. Suppliers never need an account — they interact through token-based links.
Real-Time by Default
Every state change — a new quotation, a delivery confirmation, a chat message — propagates instantly to all authorized participants via Ably WebSocket channels. There is no 'refresh to see updates.' The presence system tracks who is online, and delegation notifications alert owners when teammates make changes.
Graceful Licensing
Unlicensed users can explore a full-featured multi-industry demo environment with realistic fixture data. When a license expires, the system enters read-only mode — data is never locked away. Users can still view all orders, invoices, reports, and data. They just cannot make changes until they renew.