prometheas-labs Moon v2 — Language Patterns
Concise per-language Moon v2 patterns for common project types.
PHP
layer: application
language: php
fileGroups:
sources: ['src/**/*.php', '!src/vendor/**']
configs: ['composer.json', 'composer.lock']
tasks:
install:
command: 'composer install --no-interaction'
inputs: ['@group(configs)']
outputs: ['vendor/']
options: { cache: true }
lint:
script: 'find src -name "*.php" -not -path "*/vendor/*" -exec php -l {} \;'
inputs: ['@group(sources)']
Key patterns: Use --working-dir for nested structures (e.g., app lives in src/htdocs/). Cache vendor/ directory. Composer commands run via command: (single executable), but lint with find | exec needs script:.
JavaScript / TypeScript
layer: application
language: typescript
fileGroups:
sources: ['src/**/*.{ts,tsx}', '!src/**/*.test.*']
configs: ['package.json', 'tsconfig.json']
tasks:
build:
script: 'rm -rf dist && tsc --build'
inputs: ['@group(sources)', '@group(configs)']
outputs: ['dist/']
dev:
command: 'next dev'
preset: server # disables cache, enables persistent
Key patterns: Set javascript.packageManager in .moon/toolchains.yml (bun, npm, pnpm, yarn). Use preset: server for dev servers. Next.js outputs go in .next/. React libraries output to dist/. Node.js services typically don't need outputs.
Python
layer: application
language: python
fileGroups:
sources: ['src/**/*.py', '!**/__pycache__/**']
configs: ['pyproject.toml', 'requirements*.txt']
tasks:
install:
command: 'pip install -r requirements.txt'
inputs: ['@group(configs)']
outputs: ['.venv/']
test:
command: 'pytest'
inputs: ['@group(sources)', '@group(configs)']
deps: ['~:install']
options: { cache: true }
lint:
command: 'ruff check src/'
inputs: ['@group(sources)']
Key patterns: Python toolchain is experimental (unstable_python in toolchains.yml). Support pip, Poetry (poetry install), Pipenv, PDM, or uv. Cache .venv/ or build outputs. Use deps: ['~:install'] to ensure venv is ready.
Mobile (React Native / Flutter)
React Native — uses JavaScript toolchain:
layer: application
language: typescript
tasks:
ios:
command: 'react-native run-ios'
preset: server
android:
command: 'react-native run-android'
preset: server
pod-install:
script: 'cd ios && pod install'
inputs: ['ios/Podfile', 'ios/Podfile.lock']
outputs: ['ios/Pods/']
Flutter — uses system toolchain:
layer: application
language: dart
tasks:
build-ios:
command: 'flutter build ios --release'
inputs: ['lib/**/*.dart', 'pubspec.yaml']
outputs: ['build/ios/']
build-android:
command: 'flutter build appbundle --release'
inputs: ['lib/**/*.dart', 'pubspec.yaml']
outputs: ['build/app/']
Key patterns: Platform builds (iOS/Android) are separate tasks. CocoaPods and Gradle outputs are cacheable. Use preset: server for dev/emulator tasks. Simulator/emulator launch tasks should not be cached.