SimpleModule CLAUDE.md

CLAUDE.md

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

Attribution Policy

• Never add "Co-authored-by: Claude" or any Claude/AI attribution to git commits
• Never add comments like "Generated by Claude", "AI-generated", or similar in source code
• Never list Claude as a contributor in any file (package.json, csproj, README, etc.)
• All commits should appear as authored solely by the developer — do not modify git author/committer config
• Do not append the claude.ai session URL to commit messages

What This Is

Modular monolith framework for .NET with compile-time module discovery via Roslyn source generators. Frontend uses React 19 + Inertia.js served via a static HTML shell.

Local database (shared dev-services stack)

Do NOT start your own Postgres container. All repos in ~/Repos share one stack defined in ~/Repos/dev-services (one PostGIS + Redis + MinIO + Adminer on the devnet Docker network). Start it once with make up there.

• Local dev defaults to SQLite (app.db), so Postgres is optional here.
• To use Postgres, point the app at the shared server: localhost:5432, postgres/postgres, database simplemodule (already created by the shared stack's init SQL).
• This repo's own docker-compose.yml starts a postgres:17 container (db simplemodule, creds simplemodule/simplemodule). Prefer the shared stack and skip it — running both conflicts on port 5432. Running via the Aspire AppHost also provisions its own Postgres (simplemoduledb); that's a separate path from the shared stack.

If 5432 is taken by an old per-project container, stop that container rather than remapping ports. To add a database, edit dev-services/init/01-databases.sql.

Build & Run

dotnet build
dotnet run --project template/SimpleModule.Host     # runs on https://localhost:5001

Frontend (npm workspaces)

npm install                          # install all workspace dependencies
npm run dev                          # start development (dotnet + all module watches, unminified JS)
npm run build:dev                    # build all modules in dev mode (unminified, with source maps)
npm run build                        # production build (minified, optimized)
npm run check                        # biome lint + format check
npm run check:fix                    # auto-fix lint + formatting
npm run lint                         # lint only
npm run format                       # format only (with write)