flowOS is an offline-capable, multi-tenant business operating system for Nigerian businesses. It is a modular monolith foundation; the platform slice (authentication, organizations, memberships, RBAC, MFA) and the catalogue & inventory foundation are implemented, with further business modules to follow.
Web, mobile, and desktop clients use the Laravel API. PostgreSQL is the authoritative cloud database; Redis is temporary infrastructure for supported cache, queue, session, rate-limit, and coordination concerns. Detailed architecture and current-versus-target status live in the architecture entrypoint.
| Layer | Technology |
|---|---|
| Web | Next.js 16, React 19, TypeScript |
| API | Laravel 12, PHP, PostgreSQL 16 |
| Mobile | Flutter, Dart, Riverpod |
| Desktop | .NET 8, WPF, C# |
| Temporary infrastructure | Redis 7 |
| Local infrastructure | Docker Compose |
The API runs on a supported patched Laravel 12 line and the web client on a supported patched Next.js 16 line. See dependency security and ADR 0031.
# Automated setup (dependencies & environment)
.\scripts\dev.ps1 setup
# Start backing infrastructure & run tests
.\scripts\dev.ps1 up
.\scripts\dev.ps1 testApplications normally run natively during development. Docker Compose supplies PostgreSQL, Redis, and optional Mailpit. See development onboarding and development scripts.
apps/ Web, API, mobile, and desktop applications
packages/ OpenAPI contracts and shared packages
infrastructure/ Local infrastructure configuration
docs/ Architecture, development, engineering, security, and product documentation
scripts/ Repository development commands
- Developer onboarding & local setup
- Architecture
- Security
- Observability
- Offline architecture
- API documentation
- Engineering policy & CI
- Testing strategy
- ADRs
- Documentation index
Read contribution guidelines, developer onboarding, and AGENTS.md before contributing to the repository.