CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

SummerCMS is a planned rewrite of WinterCMS/OctoberCMS in Scala. The goal is to create a similar Content Management Framework (CMF) with improved performance and stability.

Project Status

This is a greenfield project. The repository currently contains:

golem15-wintercms-starter/ - Git submodule of the existing WinterCMS implementation (reference)
IDEA.md - High-level requirements and vision

Core Requirements (from IDEA.md)

Model/Controller/Components system - Similar to WinterCMS patterns
Modern frontend-backend communication - Replace AJAX with efficient, scalable framework
Admin backend - YAML/JSON-driven form generation
CLI scaffolding - Console commands for initial setup
Plugin/Theme system - Extensible architecture with plugin interdependencies

Reference Implementation

The WinterCMS reference is in golem15-wintercms-starter/. See its CLAUDE.md for details on:

Golem15 plugin architecture
Apparatus framework (DI, scenarios, form widgets)
PaymentGateway FSM patterns
User/Auth with JWT
Translation system

Key WinterCMS Patterns to Replicate

Plugin Structure:

Controllers, Models, Components in plugin root
YAML-based form fields and list columns (fields.yaml, columns.yaml)
Plugin dependencies via $require arrays
Event-driven model extensions

Apparatus Framework Concepts:

Scenario-based workflow engine
Automatic dependency injection for components
Backend CSS/JS injection system

Development

# Initialize submodules (to access reference implementation)
git submodule update --init --recursive

Future Scala project setup will be documented here once the build system is established.

1.8 KiB Raw Blame History