33This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
44
55## Commands
6- - Build: ` yarn build `
6+ - Build: ` yarn build ` (builds all packages in dependency order)
77- Dev: ` yarn dev ` (starts CouchDB, platform-ui, express)
88- Lint: ` yarn workspace @vue-skuilder/platform-ui lint ` or ` yarn workspace @vue-skuilder/express lint:fix `
99- Type check: ` yarn workspace @vue-skuilder/express type-check `
1010- Unit tests: ` yarn workspace @vue-skuilder/platform-ui test:unit `
1111- Run single test: ` yarn workspace @vue-skuilder/platform-ui test:unit <test-file-path> `
1212- E2E tests: ` yarn workspace @vue-skuilder/platform-ui test:e2e `
13+ - Database E2E tests: ` yarn workspace @vue-skuilder/e2e-db test `
14+
15+ ### Backend Package Commands
16+ - Build common: ` yarn workspace @vue-skuilder/common build `
17+ - Build db: ` yarn workspace @vue-skuilder/db build `
18+ - Build express: ` yarn workspace @vue-skuilder/express build `
19+ - Test e2e-db: ` yarn workspace @vue-skuilder/e2e-db test `
1320
1421## Style Guidelines
1522- Use TypeScript with strict typing
@@ -21,4 +28,23 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
2128- Use async/await for promises
2229- Error handling: try/catch blocks for async code
2330- Use ESLint and Prettier for code formatting
24- - Follow Vue 3 Composition API patterns
31+ - Follow Vue 3 Composition API patterns
32+
33+ ## TypeScript Configuration (Backend Packages)
34+ Backend packages (` common ` , ` db ` , ` express ` , ` e2e-db ` ) follow standardized TypeScript configuration:
35+
36+ ### Shared Base Configuration
37+ - ** Target** : ES2022 with strict settings enabled
38+ - ** Module System** : NodeNext for libraries, CommonJS for testing
39+ - ** Base Config** : All backend packages extend ` tsconfig.base.json `
40+
41+ ### Package-Specific Patterns
42+ - ** Shared Libraries** (` common ` , ` db ` ): Dual CommonJS/ESM exports for maximum compatibility
43+ - ** Node.js Services** (` express ` ): ES modules with NodeNext resolution
44+ - ** Testing Packages** (` e2e-db ` ): CommonJS with Jest compatibility
45+
46+ ### TypeScript Best Practices
47+ - All backend packages use consistent ES2022 target
48+ - Strict type checking enabled (noUnusedLocals, noUnusedParameters, etc.)
49+ - ESM imports use ` .mjs ` extensions in build outputs
50+ - CommonJS exports available for Jest testing compatibility
0 commit comments