shop-client/AGENTS.md

AGENTS.md — shop-client

Project structure

FSD architecture: app/pages/widgets/features/entities/shared

Developer commands

Command	What it does
npm run dev	Vite dev server on :5173, proxies /api and /uploads to 127.0.0.1:3333
npm run build	Runs tsc -b first, then vite build
npm run lint	ESLint (flat config)
npm run lint:fix	ESLint with --fix
npm run format	Prettier write all
npm run format:check	Prettier check only
npm test	vitest run
npm run test:watch	vitest watch mode

Conventions

• Language: Отвечай пользователю на русском.
• Single quotes, no semicolons, trailing commas, 120 print width (Prettier + ESLint enforce).
• FSD import boundaries enforced by eslint-plugin-boundaries. Lower layers cannot import upper layers.
• Aliases: @/ → client/src/, @shared/ → ../../shop-server/shared/
• API requests: Use apiClient (axios wrapper from shared/api/) with @tanstack/react-query. Invalidate queries after mutations.
• UI: Prefer MUI components over custom HTML/CSS.
• no-console: ESLint error; use console.warn/error/info only.

Testing

• vitest + jsdom + @testing-library/react
• Setup file: src/testing/setup.ts
• Test files live in tests/ directories next to the code they test.

Important

• shop-server must be cloned alongside shop-client for @shared/ alias to resolve.
• Vite dev server relies on backend running at 127.0.0.1:3333. Start server first.