PR

.github/workflows/ci.yml

@@ -0,0 +1,105 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Run tests
+      run: npm run test:ci
+
+    - name: Upload coverage reports
+      if: matrix.node-version == '20.x'
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage/lcov.info
+        fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20.x'
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Check for linting setup
+      run: |
+        if [ -f "package.json" ] && grep -q '"lint"' package.json; then
+          echo "Running linter..."
+          npm run lint
+        else
+          echo "No linter configured, skipping..."
+        fi
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20.x'
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Build application
+      run: npm run build
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: build-artifacts
+        path: dist/
+        retention-days: 30
+
+    - name: Upload build artifacts summary
+      run: |
+        echo "## Build Artifacts" >> $GITHUB_STEP_SUMMARY
+        echo "Build completed successfully! 🎉" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### Generated Files:" >> $GITHUB_STEP_SUMMARY
+        ls -la dist/ | tail -n +2 | while read line; do
+          echo "- $line" >> $GITHUB_STEP_SUMMARY
+        done
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### File Sizes:" >> $GITHUB_STEP_SUMMARY
+        du -h dist/* | while read size file; do
+          echo "- $(basename $file): $size" >> $GITHUB_STEP_SUMMARY
+        done

BUILD_GUIDE.md

@@ -0,0 +1,73 @@
+# Build & Deployment Guide
+
+## Development
+
+To start the development server:
+
+```bash
+npm install
+npm run dev
+```
+
+This will start Vite's development server on `http://localhost:3000` with hot module replacement.
+
+## Building for Production
+
+To build the application for production:
+
+```bash
+npm run build
+```
+
+This creates optimized production files in the `dist/` directory:
+- `vite-index.html` - Main HTML entry point
+- `assets/` - Optimized JavaScript, CSS, and source maps
+- Vendor libraries are separated into their own chunk for better caching
+
+## Preview Built Application
+
+To preview the production build locally:
+
+```bash
+npm run preview
+```
+
+This serves the built files on `http://localhost:4173`.
+
+## CI/CD Pipeline
+
+The project includes a GitHub Actions CI/CD pipeline that:
+
+1. **Tests** - Runs on Node.js 18.x and 20.x
+2. **Linting** - Checks for linting setup (currently skipped as no linter configured)
+3. **Build** - Creates production artifacts and uploads them to GitHub Actions
+4. **Artifacts** - Build artifacts are stored for 30 days and can be downloaded from the Actions tab
+
+### Pipeline Triggers
+
+- Push to `main` or `develop` branches
+- Pull requests to `main` or `develop` branches
+
+### Build Artifacts
+
+The pipeline creates and uploads:
+- Complete `dist/` folder with all production assets
+- Build summary with file sizes and generated files
+
+## Scripts
+
+- `npm run dev` - Start development server
+- `npm run build` - Build for production
+- `npm run build:clean` - Clean build directory and rebuild
+- `npm run preview` - Preview production build
+- `npm test` - Run tests once
+- `npm run test:watch` - Run tests in watch mode
+- `npm run test:ci` - Run tests with coverage for CI
+
+## Technology Stack
+
+- **Build Tool**: Vite 7.x
+- **Framework**: React 18.x
+- **Testing**: Jest with React Testing Library
+- **CI/CD**: GitHub Actions
+- **Package Manager**: npm