@@ -13,15 +13,14 @@ This is **eForm Angular Frontend**, a multi-component application consisting of:
1313### Required Software Versions
1414- ** .NET 9.x** - ** CRITICAL** : Project targets net9.0 framework
1515- ** Node.js 22.19.x+** - Required for Angular build
16- - ** npm 10.8.2+** - Package manager
17- - ** yarn 1.22.22+** - Alternative package manager (also supported)
16+ - ** yarn 1.22.19+** - Package manager (primary)
1817
1918### Development Tools Verification
2019``` bash
2120# Verify versions before starting development
2221dotnet --version # Must be 9.x
2322node --version # Should be 22.19.x+
24- npm --version # Should be 10.8.2 +
23+ yarn --version # Should be 1.22.19 +
2524```
2625
2726### External Services (Required for Full Functionality)
@@ -46,13 +45,13 @@ dotnet build # --timeout 200
4645cd eform-client
4746
4847# Install dependencies (37s) - NEVER CANCEL EARLY
49- npm install # --timeout 300
48+ yarn install # --timeout 300
5049
5150# Development build (20s)
52- npm run build # --timeout 200
51+ yarn build # --timeout 200
5352
5453# Development server (35s to start)
55- npm start # --timeout 300
54+ yarn start # --timeout 300
5655# Access at http://localhost:4200
5756```
5857
@@ -66,7 +65,7 @@ cd eform-angular-frontend
6665
6766# Install all dependencies
6867cd eFormAPI && dotnet restore
69- cd ../eform-client && npm install
68+ cd ../eform-client && yarn install
7069```
7170
7271### 2. Running Development Environment
@@ -77,7 +76,7 @@ dotnet run # Starts API server
7776
7877# Terminal 2: Start Angular dev server
7978cd eform-client
80- npm start # Starts on localhost:4200
79+ yarn start # Starts on localhost:4200
8180```
8281
8382### 3. Building for Production
@@ -88,7 +87,7 @@ dotnet build --configuration Release
8887
8988# Build Angular
9089cd eform-client
91- npm run build --prod
90+ yarn build --prod
9291```
9392
9493## Testing
@@ -101,7 +100,7 @@ dotnet test # --timeout 300
101100
102101# Angular unit tests
103102cd eform-client
104- npm run test
103+ yarn test
105104```
106105
107106### Integration Tests
@@ -114,11 +113,11 @@ dotnet test --filter "Category=Integration" # --timeout 600
114113### End-to-End Tests
115114``` bash
116115cd eform-client
117- npm run e2e # --timeout 900
116+ yarn e2e # --timeout 900
118117
119118# Multiple E2E test configurations available:
120- npm run testheadless2a # Step 2a tests
121- npm run testheadless2b # Step 2b tests
119+ yarn testheadless2a # Step 2a tests
120+ yarn testheadless2b # Step 2b tests
122121# ... up to testheadless2j
123122```
124123
@@ -142,7 +141,7 @@ If you encounter network blocks for external dependencies:
1421413 . ** xlsx Package Issues** :
143142 ``` bash
144143 # Install with --force if needed
145- npm install xlsx --force
144+ yarn add xlsx --force
146145 ```
147146
1481474 . ** Google Fonts Blocks** :
@@ -203,18 +202,18 @@ docker build -t eform-frontend -f Dockerfile-big . # --timeout 900
203202 # If wrong version, install .NET 9.x SDK
204203 ```
205204
206- 2 . ** Node/npm Version Issues** :
205+ 2 . ** Node/yarn Version Issues** :
207206 ``` bash
208207 # Check versions
209208 node --version # Should be 22.19.x+
210- npm --version # Should be 10.8.2 +
209+ yarn --version # Should be 1.22.19 +
211210 ```
212211
2132123 . ** Package Restore Failures** :
214213 ``` bash
215214 # Clear caches and reinstall
216215 cd eFormAPI && dotnet clean && dotnet restore
217- cd eform-client && rm -rf node_modules && npm install
216+ cd eform-client && rm -rf node_modules && yarn install
218217 ```
219218
2202194 . ** Test Database Connection** :
@@ -228,7 +227,7 @@ docker build -t eform-frontend -f Dockerfile-big . # --timeout 900
228227 - Ensure ports are available
229228
230229### Performance Optimization
231- - Use ` npm ci ` instead of ` npm install` in CI/CD
230+ - Use ` yarn install --frozen-lockfile ` instead of ` yarn install` in CI/CD
232231- Enable .NET build caching with ` --no-restore ` after initial restore
233232- Use Docker layer caching for faster container builds
234233
@@ -244,7 +243,7 @@ Located in `.github/workflows/`:
244243Use these timeout values in your workflows:
245244- .NET restore: 300 seconds
246245- .NET build: 200 seconds
247- - npm install: 300 seconds
246+ - yarn install: 300 seconds
248247- Angular build: 200 seconds
249248- E2E tests: 900 seconds
250249- Integration tests: 600 seconds
0 commit comments