merge: integrate pnpm migration into main

Author: jesusdev98

.github/workflows/cypress-e2e.yml

@@ -0,0 +1,62 @@
+name: Cypress E2E
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  e2e:
+    name: Cypress E2E
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.5.0
+
+      - name: Get pnpm store path
+        run: echo "PNPM_STORE_PATH=$(pnpm store path --silent)" >> "$GITHUB_ENV"
+
+      - name: Restore pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.PNPM_STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build production app
+        run: pnpm run build
+
+      - name: Start Angular dev server
+        run: |
+          pnpm start --host 127.0.0.1 --port 4200 > angular-server.log 2>&1 &
+          echo $! > angular-server.pid
+
+      - name: Wait for Angular dev server
+        run: |
+          for i in {1..90}; do
+            if curl --silent --fail http://127.0.0.1:4200 > /dev/null; then
+              exit 0
+            fi
+            sleep 1
+          done
+          cat angular-server.log
+          exit 1
+
+      - name: Run Cypress E2E
+        run: pnpm run e2e

.github/workflows/deploy-pages.yml

@@ -43,7 +43,7 @@ jobs:
         run: pnpm test --watch=false
 
       - name: Build Angular app
-        run: pnpm run build -- --configuration production --base-href /${{ github.event.repository.name }}/
+        run: pnpm run build --configuration production --base-href /${{ github.event.repository.name }}/
 
       - name: Add SPA fallback
         run: cp dist/devbreak-timer/browser/index.html dist/devbreak-timer/browser/404.html

README.md

@@ -9,6 +9,7 @@ FocusFlow combines a focus timer, Pomodoro workflows, Kanban planning, and light
 ![Angular](https://img.shields.io/badge/Angular-21-DD0031?style=flat-square&logo=angular&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white)
 ![RxJS](https://img.shields.io/badge/RxJS-7.8-B7178C?style=flat-square&logo=reactivex&logoColor=white)
+![pnpm](https://img.shields.io/badge/pnpm-11-F69220?style=flat-square&logo=pnpm&logoColor=white)
 ![PWA](https://img.shields.io/badge/PWA-Installable-5A0FC8?style=flat-square)
 ![Cypress](https://img.shields.io/badge/Cypress-E2E-17202C?style=flat-square&logo=cypress&logoColor=white)
 ![i18n](https://img.shields.io/badge/i18n-EN%20%7C%20ES%20%7C%20FR-2563EB?style=flat-square)
@@ -127,13 +128,13 @@ Architecture highlights:
 Install dependencies:
 
 ```bash
-npm install
+pnpm install
 ```
 
 Run the local development server:
 
 ```bash
-npm start
+pnpm start
 ```
 
 Open:
@@ -145,21 +146,23 @@ http://localhost:4200/
 Create a production build:
 
 ```bash
-npm run build
+pnpm run build
 ```
 
 Run unit tests:
 
 ```bash
-npm test -- --watch=false
+pnpm test --watch=false
 ```
 
 Run Cypress:
 
 ```bash
-npm run e2e
+pnpm run e2e
 ```
 
+> On local Windows shells, make sure `ELECTRON_RUN_AS_NODE` is not set before launching Cypress.
+
 ## PWA Support
 
 FocusFlow is configured as an Angular PWA for production builds.
@@ -201,13 +204,26 @@ Deployment profile:
 Recommended release checks:
 
 ```bash
-npm ci
-npm run build
-npm test -- --watch=false
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm test --watch=false
+pnpm run e2e
 ```
 
 For PWA behavior, validate installability and offline reload from a production build over HTTPS or localhost.
 
+## CI/CD
+
+GitHub Actions uses Node 22 and pnpm 11. The main CI workflow installs dependencies with `pnpm install --frozen-lockfile`, runs unit tests with `pnpm test --watch=false`, and builds the production app with `pnpm run build`.
+
+The GitHub Pages deployment workflow also uses pnpm and builds with the repository base href:
+
+```bash
+pnpm run build --configuration production --base-href /FocusFlow/
+```
+
+The Cypress E2E workflow starts the Angular dev server with pnpm and runs the Cypress suite against `http://127.0.0.1:4200`.
+
 ## Future Improvements
 
 The current app is complete as a local-first PWA. Realistic future additions could include:
@@ -255,3 +271,14 @@ FocusFlow running from the public production deployment.
 Installed Android PWA experience.
 
 ![FocusFlow Mobile PWA](./screenshots/focusflow-mobile-pwa.png)
+
+---
+
+## Screenshot Folder Structure
+
+```text
+screenshots/
+  focusflow-desktop.png
+  focusflow-web.png
+  focusflow-mobile-pwa.png
+```