CLAUDE.md

1# CLAUDE.md
2 
3## Commit Message Guidelines
4 
5When making commits, follow these rules:
6 
7- Keep messages CONCISE (no walls of text)
8- Subject line under 72 chars as a single sentence (no body text, no bullets, no lists)
9- NO emojis
10- NO promotional text or links
11- NO Co-Authored-By lines
12- ONLY run pre-commit checks (format, lint, typecheck, build) when explicitly creating a commit
13 
14Example:
15 
16```
17Format markdown files with Prettier for consistent styling
18```
19 
20## Commands
21 
22```sh
23# Install dependencies from the committed lockfile
24npm ci
25# Fast path when the lock file has not changed since the last npm ci, OR when
26# adding or updating dependencies.
27npm install
28 
29# Run development servers
30npm run dev          # Photos app (port 3000)
31npm run dev:auth     # Auth app (port 3003)
32# ...
33npm run              # To see the full list of apps
34 
35# Production builds
36npm run build        # Photos app
37npm run build:auth   # Auth app
38...
39 
40# Code quality. Run when:
41# 1. Explicitly requested by user
42# 2. Before creating a commit (pre-commit)
43# Do not run automatically after file modifications
44npm run lint          # Check formatting, linting, and TypeScript types
45npm run lint:fix      # Auto-fix linting and formatting issues
46```
47 
48## Structure
49 
50This is a monorepo containing multiple Ente web applications using npm workspaces.
51 
52Shared code goes in `packages/`. All apps use Next.js for static export except `payments`. Run `ls apps/` and `ls packages/` to see the full list.
53