Merge branch 'feat/dashboard-analytics'

Author: emdevelopa

.github/workflows/pr-checks.yml

@@ -23,11 +23,10 @@ jobs:
   # 2. PR title prefix → type labels (enhancement, bug, docs, etc.)
   auto-label:
     if: >-
+      github.event.action == 'opened' &&
       github.event.pull_request.user.login != 'github-actions[bot]' &&
       github.event.pull_request.user.login != 'release-please[bot]' &&
-      github.event.pull_request.user.login != 'dependabot[bot]' &&
-      github.event.action != 'labeled' &&
-      github.event.action != 'unlabeled'
+      github.event.pull_request.user.login != 'dependabot[bot]'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6

.husky/pre-commit

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

.lintstagedrc

@@ -0,0 +1,4 @@
+{
+  "*.{ts,tsx}": ["cd frontend && pnpm exec eslint --fix"],
+  "*.rs": ["cargo fmt --check"]
+}

CONTRIBUTING.md

@@ -35,12 +35,25 @@ cargo build --target wasm32-unknown-unknown --release
 
 ```bash
 cd frontend
+cp .env.example .env  # Copy environment variables
 pnpm install
 pnpm dev        # Start dev server
 pnpm build      # Production build
 pnpm lint       # Run linter
 ```
 
+### Pre-commit Hooks
+
+This project uses [husky](https://typicode.github.io/husky/) and [lint-staged](https://github.com/lint-staged/lint-staged) to run automated checks before commits. The pre-commit hook runs:
+
+- **ESLint** on staged `.ts`/`.tsx` files in the frontend
+- **cargo fmt --check** on staged `.rs` files in the contracts
+
+These checks help prevent formatting issues from reaching CI. The hooks are automatically installed after running `pnpm install` in the frontend directory.
+
+To troubleshoot hook issues, check `.husky/pre-commit` and `.lintstagedrc`.
+The `.env.example` file contains optional configuration for connecting to Stellar testnet. These variables will be required once contract integration is complete.
+
 ## Branch Naming
 
 Use conventional prefixes:

README.md

@@ -245,7 +245,7 @@ See [SECURITY.md](SECURITY.md) for vulnerability disclosure.
 
 <p align="center">
   <a href="https://github.com/lernza/lernza/graphs/contributors">
-    <img src="https://contrib.rocks/image?repo=lernza/lernza" alt="Contributors" />
+    <img src="https://stg.contrib.rocks/image?repo=lernza/lernza" alt="Contributors" />
   </a>
 </p>
 

frontend/.env.example

@@ -0,0 +1,10 @@
+# Soroban RPC endpoint for chain interactions
+VITE_SOROBAN_RPC_URL=https://soroban-testnet.stellar.org
+
+# Network identifier (testnet/mainnet)
+VITE_NETWORK_PASSPHRASE=Test SDF Network ; September 2015
+
+# Contract addresses (deploy your own contracts or use deployed addresses)
+VITE_QUEST_CONTRACT_ID=
+VITE_MILESTONE_CONTRACT_ID=
+VITE_REWARDS_CONTRACT_ID=

frontend/.gitignore

@@ -11,6 +11,8 @@ node_modules
 dist
 dist-ssr
 *.local
+.env
+.env.local
 
 # Editor directories and files
 .vscode/*