ci: add Husky pre-commit hooks for lint and formatting

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.husky/pre-push

@@ -0,0 +1 @@
+npx tsc --noEmit

.prettierignore

@@ -0,0 +1,7 @@
+.next
+out
+build
+node_modules
+public/mockServiceWorker.js
+public/sw.js
+package-lock.json

.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "endOfLine": "lf"
+}

CONTRIBUTING.md

@@ -1,5 +1,54 @@
 # Contributing to ILN Frontend
 
+## Pre-commit Hooks (Husky)
+
+This project uses [Husky](https://typicode.github.io/husky/) and [lint-staged](https://github.com/lint-staged/lint-staged) to catch lint and formatting issues locally before they reach CI.
+
+### First-time Setup
+
+After cloning the repo, install dependencies to activate the hooks:
+
+```bash
+npm install
+```
+
+The `prepare` script runs `husky` automatically, registering the hooks in `.husky/`.
+
+### What the hooks do
+
+| Hook | Trigger | Action |
+|------|---------|--------|
+| `pre-commit` | `git commit` | Runs `eslint --fix` and `prettier --write` on staged files only |
+| `pre-push` | `git push` | Runs `tsc --noEmit` to catch type errors before the branch is pushed |
+
+Hooks are scoped to staged files via `lint-staged`, so they typically complete in well under 10 seconds.
+
+### Skipping hooks (not recommended)
+
+If you genuinely need to bypass a hook in an emergency:
+
+```bash
+# Skip pre-commit only
+git commit --no-verify -m "your message"
+
+# Skip pre-push only
+git push --no-verify
+```
+
+Do not make a habit of skipping — the same checks run in CI and will block your PR.
+
+### Prettier configuration
+
+Formatting rules live in `.prettierrc.json`. Files and directories excluded from formatting are listed in `.prettierignore`.
+
+To format the entire codebase manually:
+
+```bash
+npx prettier --write .
+```
+
+---
+
 ## Visual Regression Testing with Chromatic
 
 This project uses Chromatic for visual regression testing to catch unintended UI changes before they reach production.

package.json

@@ -11,7 +11,8 @@
     "test:e2e": "playwright test",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
-    "chromatic": "chromatic --exit-zero-on-changes"
+    "chromatic": "chromatic --exit-zero-on-changes",
+    "prepare": "husky"
   },
   "dependencies": {
     "@stellar/freighter-api": "^6.0.1",
@@ -67,7 +68,19 @@
     "eslint-plugin-storybook": "^10.4.1",
     "playwright": "^1.60.0",
     "@vitest/browser-playwright": "^4.1.5",
-    "@vitest/coverage-v8": "^4.1.5"
+    "@vitest/coverage-v8": "^4.1.5",
+    "husky": "9.1.7",
+    "lint-staged": "15.5.2",
+    "prettier": "3.5.3"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,mjs,cjs}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,css,md}": [
+      "prettier --write"
+    ]
   },
   "msw": {
     "workerDirectory": [