Central Monorepo

A centralized monorepo containing multiple projects organized by company/product, managed using Git submodules.

Overview

This repository serves as a unified development environment for projects across different companies and products:

• DNC - DoNotCarry delivery service platform (Laravel backends, React Native apps, utilities)
• KCC - KCC Booklet projects (mobile app and backend)
• Metrix - Metrix Group projects (AR experiences, MCP servers)
• ReyemTech - Reyem Tech infrastructure and websites (Kubernetes, Laravel apps, packages)

Quick Start

Clone with Submodules

# Clone with all submodules
git clone --recursive git@github.com:mariomeyer/code.git central
cd central

# Or if already cloned, initialize submodules
git submodule update --init --recursive

Update Submodules

# Update all submodules to latest
git submodule update --remote

# Update specific submodule
git submodule update --remote DNC/backend/v2

Repository Structure

central/
├── DNC/                      # DoNotCarry Projects
│   ├── apps/
│   │   ├── customer/        # React Native customer app
│   │   ├── driver/          # React Native driver app
│   │   └── fastlane/        # Fastlane configuration
│   ├── backend/
│   │   ├── v1/              # Laravel 9 + Homestead
│   │   └── v2/              # Laravel 11 + Sail + Filament
│   └── utils/
│       ├── api-sdk/         # API SDK package
│       ├── filament-google-maps/
│       └── geokit/          # Geolocation utilities
│
├── KCC/                      # KCC Booklet
│   └── Booklet/
│       ├── app/             # React Native app
│       └── laravel/         # Laravel backend
│
├── Metrix/                   # Metrix Group
│   ├── AR-Character/        # Augmented reality project
│   └── mcp-insights/        # MCP server for Neo4j knowledge graphs
│
└── ReyemTech/               # Reyem Tech
    ├── cluster/             # Kubernetes infrastructure (Terraform)
    ├── gta-events/          # Laravel 12 + Inertia + React
    ├── sail/                # Docker/Helm scaffolding package
    └── website/             # Company website (Laravel)

Key Projects

DoNotCarry Backend v2

Laravel 11 application with Filament admin panel, running on Laravel Sail.

cd DNC/backend/v2
./vendor/bin/sail up -d

Access: http://localhost or https://local.donotcarry.tech

ReyemTech GTA Events

Laravel 12 with Inertia v2, React 19, and Wayfinder for type-safe routing.

cd ReyemTech/gta-events
php artisan serve
npm run dev

ReyemTech Kubernetes Cluster

Production-ready Kubernetes cluster with Traefik, Vault, MySQL/Redis operators.

cd ReyemTech/cluster
terraform init
terraform apply

Metrix MCP Insights

MCP server for Neo4j knowledge graph integration with AI agents.

cd Metrix/mcp-insights
pip install -e .
python -m mcp_neo4j_insights.server

Working with Submodules

Making Changes in a Submodule

# Navigate to submodule
cd DNC/backend/v2

# Make changes and commit
git add .
git commit -m "Your changes"
git push

# Return to parent and update submodule reference
cd ../..
git add DNC/backend/v2
git commit -m "Update backend v2 submodule"
git push

Adding a New Submodule

git submodule add <repository-url> <path>
git commit -m "Add new submodule"
git push

Development Environments

Different projects use different development environments:

Project	Environment	Commands
DNC Backend v1	Vagrant/Homestead	make environment, vagrant up
DNC Backend v2	Laravel Sail (Docker)	./vendor/bin/sail up -d
ReyemTech GTA Events	Native PHP	php artisan serve, npm run dev
ReyemTech Cluster	Terraform + Kubernetes	terraform apply
Metrix MCP Insights	Python	python -m mcp_neo4j_insights.server
DNC Mobile Apps	React Native	Standard RN commands

Documentation

• CLAUDE.md - Comprehensive guide for AI assistants working with this codebase
• Individual project READMEs are located in each submodule directory

Tech Stack

Backend

• Laravel 9, 11, 12
• PHP 8.2, 8.3, 8.4+
• MySQL, Redis
• Filament v3 (admin panels)
• Livewire v3, Volt
• Inertia.js v2

Frontend

• React 19
• React Native
• Tailwind CSS v3, v4
• Vite

Infrastructure

• Docker, Docker Compose
• Kubernetes
• Terraform
• Traefik (ingress)
• HashiCorp Vault
• AWS Route53, S3

Testing

• PHPUnit, Pest 4
• Jest (React Native)
• Browser testing (Pest 4)

DevOps

• Laravel Sail
• Homestead/Vagrant
• GitHub Actions
• Custom Helm charts

Contributing

When contributing to any submodule:

1. Check for project-specific CLAUDE.md or README.md files
2. Follow the project's testing requirements (Pest or PHPUnit)
3. Run code formatters (Laravel Pint for PHP projects)
4. Commit changes in the submodule first, then update the parent repo

License

Each project may have its own license. Check individual submodule repositories for details.

Maintainer

Mario Meyer (@mariomeyer)