php-devops/README.md

Host UK Developer Workspace

This repository bootstraps a complete Host UK development environment.

Quick Start

# 1. Clone this repo
git clone git@github.com:host-uk/core-devops.git
cd core-devops

# 2. Check your environment
core doctor

# 3. Clone all packages
core setup

# 4. Start developing
cd packages/core-php
composer install

Prerequisites

Run core doctor to check your environment. You'll need:

• Git - Version control
• GitHub CLI (gh) - For issues, PRs, CI status
• PHP 8.3+ - Laravel packages
• Composer - PHP dependencies
• Node.js 20+ - Frontend builds
• pnpm - Package manager (preferred over npm)

Optional but recommended:

• Claude Code - AI-assisted development
• Docker - For FrankenPHP runtime

Commands

core setup              # Clone all repos into packages/
core setup --only foundation,module  # Clone specific types
core doctor             # Check environment health
core doctor --fix       # Attempt to fix issues

# Once set up, standard core commands work:
core health             # Status summary
core work               # Commit and push workflow
core issues             # View GitHub issues

Structure

core-devops/
├── packages/           # Cloned repositories (git-ignored)
│   ├── core-php/
│   ├── core-tenant/
│   └── ...
├── repos.yaml          # Package registry
└── README.md

Updating

core pull               # Pull updates for all repos
core pull --all         # Pull even if not behind

Troubleshooting

"core: command not found" Install the Core CLI from https://github.com/Snider/Core

"gh: command not found" Install GitHub CLI: brew install gh then gh auth login

Clone failures Check your SSH keys: ssh -T git@github.com