054852fcde
- Add mobile-release.yml workflow: - Manual trigger with app (worker/client) and environment (dev/stage/prod) selection - Version validation (semantic versioning) - Tag creation with format: krow-withus-<app>-mobile/<env>-vX.Y.Z - GitHub Release creation with CHANGELOG extraction - Release naming: 'Krow With Us - Worker Mobile - DEV - v0.1.0' - Pre-release support - Add mobile-hotfix.yml workflow: - Emergency production fix automation - Creates hotfix branch from production tag - Auto-increments PATCH version - Updates pubspec.yaml and CHANGELOG.md - Creates PR with hotfix instructions - Follows documented hotfix process Both workflows support staff (worker) and client mobile apps independently. Implements mobile release strategy from docs/release/
KROW Workforce Monorepo
KROW is a comprehensive workforce management platform designed to streamline operations for events, hospitality, and enterprise staffing. This monorepo contains all components of the ecosystem, from the data layer to the user-facing applications.
🚀 Repository Structure
📦 Apps (/apps)
These are the production-ready applications for our users:
web-dashboard/: The primary React/Vite dashboard for Admin, Vendors, and Clients.mobile/: Flutter applications for client and staff.client: The application for final clients to manage orders and billing.staff: The application for staff members (scheduling, clock-in/out, earnings).
⚙️ Backend (/backend)
The core data engine powering all applications:
dataconnect/: Firebase Data Connect configuration, GraphQL schemas (PostgreSQL), and auto-generated SDKs.
🛠️ Internal (/internal)
Tools and resources for the development and operations team:
launchpad/: A secure portal (DevOps Launchpad) to access internal resources, documentation, and infrastructure links.api-harness/: A technical tool for testing and validating the Data Connect API and Cloud Functions.prototypes/: Reference code and visual prototypes (synchronized from external sources).
📂 Support Directories
/docs: Project vision, technical specifications, and guides./makefiles: ModularizedMakefilelogic for project automation./scripts: Automation scripts (security, hachage, environment setup)./firebase: Global Firebase configuration (Firestore/Storage rules).
🛠️ Tech Stack
- Frontend: React (Vite)
- Mobile: Flutter
- Backend: Firebase (Data Connect, Auth, Hosting, Functions)
- Database: PostgreSQL (managed via Cloud SQL & Data Connect)
- Infrastructure: Google Cloud Platform (GCP)
📦 Getting Started
This project uses a modular Makefile for all common tasks.
-
View available commands:
make help -
Install dependencies (Web):
make install -
Run the Web Dashboard locally:
make dev -
Run the DevOps Launchpad locally:
make launchpad-dev
📚 Documentation
- 00-vision.md: Project objectives and guiding principles.
- 01-backend-api-specification.md: (Legacy) Reference for data schemas.
- 02-codemagic-env-vars.md: Guide for CI/CD environment variables.
- 03-contributing.md: Guidelines for new developers and setup checklist.
- 04-sync-prototypes.md: How to sync prototypes for local dev and AI context.
Mobile Development Documentation
- MOBILE/01-architecture-principles.md: Flutter clean architecture, package roles, and dependency flow.
- MOBILE/02-design-system-usage.md: Design system components and theming guidelines.
- MOBILE/00-agent-development-rules.md: Rules and best practices for mobile development.
🤝 Contributing
New to the team? Please read our Contributing Guide to get your environment set up and understand our workflow.
© 2026 KROW Workforce / Oloodi Technologies Inc.