Merge pull request #4 from astrowq/dev/frontend

Migrate to pnpm and update development instructions

Author: astrowq

.cursor/rules/aperture-project.mdc

@@ -18,4 +18,4 @@ alwaysApply: true
 
 **Commits:** Conventional — `feat:`, `fix:`, `docs:`, `test:`, `refactor:`, `chore:`.
 
-**Run:** `docker compose up -d` (UI :3000, API :8000). Dev: backend `uvicorn app.main:app --reload`, frontend `npm run dev`. Tests: `cd backend && pytest tests/ -v`. Build check: `cd frontend && npm run build`.
+**Run:** `docker compose up -d` (UI :3000, API :8000). Dev: backend `uvicorn app.main:app --reload`, frontend `pnpm run dev`. Tests: `cd backend && pytest tests/ -v`. Build check: `cd frontend && pnpm run build`.

.github/workflows/frontend-ci.yml

@@ -0,0 +1,41 @@
+name: Frontend CI
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - 'frontend/**'
+      - '.github/workflows/frontend-ci.yml'
+  pull_request:
+    branches: [main, master]
+    paths:
+      - 'frontend/**'
+      - '.github/workflows/frontend-ci.yml'
+
+defaults:
+  run:
+    working-directory: frontend
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.32.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+          cache-dependency-path: frontend/pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm run build

AGENTS.md

@@ -23,9 +23,9 @@
 
 - **Full stack:** `docker compose up -d` → UI http://localhost:3000, API http://localhost:8000
 - **Backend dev:** `cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload`
-- **Frontend dev:** `cd frontend && npm install && npm run dev`
+- **Frontend dev:** `cd frontend && pnpm install && pnpm run dev`
 - **Backend tests:** `cd backend && pytest tests/ -v`
-- **Frontend build:** `cd frontend && npm run build`
+- **Frontend build:** `cd frontend && pnpm run build`
 
 ## Conventions
 

CONTRIBUTING.md

@@ -25,7 +25,7 @@ Open a GitHub issue with the `enhancement` label. Describe:
 2. Create a feature branch: `git checkout -b feature/your-feature-name`
 3. Make your changes following the guidelines below
 4. Run tests: `cd backend && pytest tests/ -v`
-5. Build the frontend: `cd frontend && npm run build`
+5. Build the frontend: `cd frontend && pnpm run build`
 6. Open a pull request with a clear description of your changes
 
 ## Development Setup

DOCS.md

@@ -173,8 +173,8 @@ API docs available at http://localhost:8000/docs
 
 ```bash
 cd frontend
-npm install
-npm run dev
+pnpm install
+pnpm run dev
 ```
 
 UI available at http://localhost:5173

frontend/Dockerfile

@@ -1,12 +1,14 @@
 FROM node:20-alpine AS builder
 
+RUN corepack enable && corepack prepare pnpm@10.32.1 --activate
+
 WORKDIR /app
 
-COPY package*.json ./
-RUN npm ci
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile
 
 COPY . .
-RUN npm run build
+RUN pnpm run build
 
 FROM nginx:alpine
 COPY --from=builder /app/dist /usr/share/nginx/html