81 lines
1.8 KiB
Markdown
81 lines
1.8 KiB
Markdown
|
# Host UK Developer Workspace
|
||
|
|
|
||
|
|
This repository bootstraps a complete Host UK development environment.
|
||
|
|
|
||
|
|
## Quick Start
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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`
|