MokoDPCalendarAPI/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code when working with this repository.

Project Overview

MokoDPCalendarAPI -- Joomla Web Services plugin exposing DPCalendar events, calendars, and locations via REST API

Field	Value
Platform	joomla
Language	PHP
Default branch	main
License	GPL-3.0-or-later
Wiki	MokoDPCalendarAPI Wiki
Standards	MokoStandards

Common Commands

composer install  # Install PHP dependencies

Architecture

This is a Joomla extension. Key directories:

• src/ -- extension source (deployed to Joomla)
• src/*.xml -- manifest file (version, files, params)
• src/src/ or src/services/ -- PHP classes
• src/language/ -- translation strings
• src/media/ -- CSS/JS/images

Rules

• Workflow directory: .mokogitea/ (not .gitea/ or .github/)

• Never commit .claude/, .mcp.json, TODO.md, or *.min.css/*.min.js

• Attribution: use Authored-by: Moko Consulting in commits

• Branch strategy: develop on dev, merge to main for release

• Minification: handled at build time (CI) and runtime (MokoMinifyHelper for Joomla templates)

• Wiki: documentation lives in the Gitea wiki, not in docs/ files

• Standards: this repo follows MokoStandards