Files

bwnyasse 984da528fb feat: add prototype syncing for local dev and AI context

This commit introduces a new feature to synchronize prototypes
from an external repository for local development and to provide
context for AI tools.

- Added `make sync-prototypes` target to Makefile to build and
 copy prototypes from the adjacent 'client-krow-poc' repository.
- Added `.geminiignore` entries to prevent Gemini from ignoring
 prototypes, ensuring they are available for context.
- Added `.gitignore` entries to ignore generated prototype files,
 except for the `.keep` files, to keep the directories.
- Added `04-sync-prototypes.md` documentation to explain how to
 sync prototypes.
- Removed empty `internal/prototypes/.keep` file.

2026-01-10 23:04:56 -05:00

3.0 KiB

Raw Blame History

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-client/: Flutter application for final clients to manage orders and billing.
mobile-staff/: Flutter 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: Modularized Makefile logic 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.

🤝 Contributing

New to the team? Please read our Contributing Guide to get your environment set up and understand our workflow.

3.0 KiB Raw Blame History