configured github flows and CI actions

.github/workflows/README.md

@@ -0,0 +1,35 @@
+# CI/CD Workflow
+
+This directory contains GitHub Actions workflows for automated testing and validation.
+
+## CI / Validation Workflow (`.github/workflows/test.yml`)
+
+**Purpose**: Prevents regressions by running all test suites and linting on every pull request to main.
+
+**Triggers**:
+
+- Pull requests targeting the `main` branch
+
+**What it does**:
+
+1. **Setup**: Installs Rust (stable) and Node.js (v20) with dependency caching
+2. **Dependency Installation**: Uses `npm install` for both backend and frontend
+3. **Code Quality**: Runs linting on both backend and frontend (if configured)
+4. **Backend Tests**: Runs `npm test --if-present` in `/backend` (Vitest + TypeScript)
+5. **Frontend Tests**: Runs `npm test --if-present` in `/frontend` (Jest + React Testing Library)
+6. **Smart Contract Tests**: Runs `cargo test` in `/contracts` (Rust)
+
+**Failure Behavior**:
+
+- Workflow fails if any test or linting step fails
+- Blocks PR merge until all checks pass
+- Uses `--if-present` to avoid failures when test scripts are missing
+
+**Requirements for Contributors**:
+
+- Ensure lint and test scripts are properly configured in `package.json`
+- Tests must pass in all directories where they exist
+- New dependencies should be added to respective `package.json` files
+- Backend uses Vitest, frontend uses Jest
+
+**Note**: The workflow uses `continue-on-error: false` to ensure strict validation - any failure will prevent the PR from being merged.

.github/workflows/test.yml

@@ -0,0 +1,68 @@
+name: CI / Validation
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: stable
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Cache Rust dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            contracts/target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('contracts/**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install backend dependencies
+        run: npm install
+        working-directory: ./backend
+
+      - name: Install frontend dependencies
+        run: npm install
+        working-directory: ./frontend
+
+      - name: Run linting (backend)
+        run: npm run lint --if-present
+        working-directory: ./backend
+        continue-on-error: false
+
+      - name: Run linting (frontend)
+        run: npm run lint --if-present
+        working-directory: ./frontend
+        continue-on-error: false
+
+      - name: Run Rust tests
+        run: cargo test
+        working-directory: ./contracts
+        continue-on-error: false
+
+      - name: Run backend tests
+        run: npm test --if-present
+        working-directory: ./backend
+        continue-on-error: false
+
+      - name: Run frontend tests
+        run: npm test --if-present
+        working-directory: ./frontend
+        continue-on-error: false

backend/package.json

@@ -38,4 +38,4 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }
-}
+}

backend/tsconfig.json

@@ -43,4 +43,4 @@
     "src/**/*",
     "tests/**/*"
   ]
-}
+}

frontend/__tests__/placeholder.test.tsx

@@ -0,0 +1,6 @@
+// Placeholder test to ensure test suite runs
+describe("Frontend Tests", () => {
+  test("placeholder test", () => {
+    expect(1).toBe(1);
+  });
+});

frontend/jest.config.js

@@ -0,0 +1,15 @@
+const nextJest = require("next/jest");
+
+const createJestConfig = nextJest({
+  dir: "./",
+});
+
+const customJestConfig = {
+  setupFilesAfterEnv: ["<rootDir>/jest.setup.js"],
+  moduleNameMapping: {
+    "^@/(.*)$": "<rootDir>/$1",
+  },
+  testEnvironment: "jest-environment-jsdom",
+};
+
+module.exports = createJestConfig(customJestConfig);

frontend/jest.setup.js

@@ -0,0 +1 @@
+import "@testing-library/jest-dom";

frontend/package.json

@@ -6,7 +6,8 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "eslint"
+    "lint": "eslint",
+    "test": "jest --passWithNoTests=false"
   },
   "dependencies": {
     "next": "16.1.6",
@@ -20,8 +21,13 @@
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
+    "@types/jest": "^29.5.0",
+    "@testing-library/react": "^14.0.0",
+    "@testing-library/jest-dom": "^6.0.0",
     "eslint": "^9",
     "eslint-config-next": "16.1.6",
+    "jest": "^29.5.0",
+    "jest-environment-jsdom": "^29.5.0",
     "tailwindcss": "^4",
     "typescript": "^5"
   }