CLAUDE.md

This file provides guidance to Claude Code and similar agents when working in this repository.

Session Startup

Read these files in order before planning, coding, reviewing, or deploying:

memory.md
docs/architecture.md
docs/api-reference.md
AGENTS.md

Use docs/agents/handoff.md only as supplemental background when the primary docs are not enough.

Project Overview

yoyuzh.xyz is a full-stack personal site focused on:

account/auth flows
personal cloud drive
quick transfer
admin console
Capacitor Android shell

Commands

Do not run frontend business commands from the repository root.

Frontend (`cd front`)

npm run dev
npm run build
npm run preview
npm run clean
npm run lint
npm run test

Backend (`cd backend`)

mvn spring-boot:run
mvn spring-boot:run -Dspring-boot.run.profiles=dev
mvn test
mvn package

There is no dedicated backend lint or typecheck command.

Deploy

node scripts/deploy-front-oss.mjs
node scripts/deploy-front-oss.mjs --dry-run
node scripts/deploy-front-oss.mjs --skip-build
node scripts/deploy-android-apk.mjs
node scripts/deploy-android-release.mjs

The deploy scripts now prefer the repository root .env file and keep .env.oss.local only as a legacy fallback.

Repo Conventions

Root .env is the shared local secrets and deploy-config entrypoint.
.env.example is the template.
memory.md is the main continuity file.
docs/agents/ stores only the supplemental handoff doc; CLAUDE.md itself stays at the repository root.

Known Constraints

Frontend production still hardcodes https://api.yoyuzh.xyz/api in front/.env.production.
Vite build chunk warnings do not currently block release.
Backend service metadata and SSH-related secrets have been consolidated into root .env; do not echo those values in normal responses.

1.9 KiB Raw Permalink Blame History