Merge branch 'main' into ref/homepage-code-refactor-issue-60

Author: Francis6-git

.eslintrc.json

@@ -1,8 +1,5 @@
 {
-  "extends": [
-    "expo",
-    "plugin:@typescript-eslint/recommended"
-  ],
+  "extends": ["expo", "plugin:@typescript-eslint/recommended"],
   "plugins": ["@typescript-eslint", "prettier"],
   "parser": "@typescript-eslint/parser",
   "parserOptions": {

.github/BRANCH_PROTECTION.md

@@ -3,16 +3,19 @@
 To enforce the CI/CD pipeline quality gates, configure branch protection rules in your GitHub repository:
 
 ## Settings Location
+
 Go to: Repository Settings → Branches → Add rule
 
 ## Required Settings for `main` branch:
 
 ### Branch name pattern
+
 ```
 main
 ```
 
 ### ✅ Required checks (enable ALL):
+
 - [ ] **typescript-lint** - ESLint and Prettier checks
 - [ ] **typescript-typecheck** - TypeScript type validation
 - [ ] **typescript-tests** - Jest test suite
@@ -23,6 +26,7 @@ main
 - [ ] **rust-build** - Rust contract compilation
 
 ### Additional protections:
+
 - [x] Require pull request before merging
 - [x] Require at least 1 approval (recommended)
 - [x] Dismiss stale reviews
@@ -31,13 +35,15 @@ main
 - [x] Do not allow bypassing the above settings
 
 ## Settings Location for `dev` branch (optional):
+
 Similar settings, but you may allow force pushes for rapid development.
 
 ---
 
 ## Verification
 
 After setting up, verify by:
+
 1. Creating a test PR
 2. Intentionally break a lint rule
 3. Verify the PR cannot be merged until fixed

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,7 @@
 ## Pull Request Checklist
 
 ### Quality Gates (All must pass before merge)
+
 - [ ] **Lint**: Code passes ESLint and Prettier checks
 - [ ] **Type Check**: TypeScript compilation succeeds
 - [ ] **Tests**: All tests pass
@@ -11,12 +12,14 @@
 - [ ] **Rust Build**: Smart contracts compile successfully
 
 ### Additional Requirements
+
 - [ ] New code has appropriate TypeScript types
 - [ ] No hardcoded secrets or credentials
 - [ ] New features have corresponding tests
 - [ ] Documentation updated if needed
 
 ### Reviewers
+
 - At least 1 approval required for merge
 - All CI checks must be green
 

.husky/pre-commit

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

BUILD_FIX_GUIDE.md

@@ -7,19 +7,22 @@ Your build is failing due to **React Native dependency version mismatches** with
 ## 🔍 **Root Cause Analysis**
 
 ### **Error Details**
+
 ```
 > Task :react-native-gesture-handler:compileDebugKotlin FAILED
 > Task :react-native-screens:compileDebugKotlin FAILED
 ```
 
 ### **Why This Happens**
+
 - **Expo SDK 53** uses **React Native 0.79.5**
 - **React Native Gesture Handler** and **Screens** have version compatibility issues
 - **Kotlin compilation** fails due to missing abstract method implementations
 
 ## 🛠️ **SOLUTION OPTIONS**
 
 ### **Option 1: Use the Fix Script (Recommended)**
+
 ```bash
 # Make script executable
 chmod +x fix-build.sh
@@ -29,6 +32,7 @@ chmod +x fix-build.sh
 ```
 
 ### **Option 2: Manual Fix**
+
 ```bash
 # Step 1: Clean everything
 rm -rf node_modules/
@@ -56,6 +60,7 @@ cd ..
 ```
 
 ### **Option 3: Downgrade React Native (Alternative)**
+
 If the above doesn't work, you can try using React Native 0.78.x:
 
 ```bash
@@ -71,6 +76,7 @@ npx expo prebuild --platform android --clean
 ## 🔧 **WHAT THE FIX SCRIPT DOES**
 
 ### **Step-by-Step Process**
+
 1. **🧹 Complete Cleanup**: Removes all build artifacts and dependencies
 2. **📦 Dependency Reset**: Reinstalls all packages with compatible versions
 3. **🔄 Cache Clear**: Clears Expo cache and fixes dependency conflicts
@@ -79,13 +85,15 @@ npx expo prebuild --platform android --clean
 6. **📱 APK Output**: Creates `builds/subtrackr.apk`
 
 ### **Files Modified**
+
 - `package.json` - Updated with compatible versions
 - `package.json.backup` - Backup of original configuration
 - `builds/` - New output directory for APK
 
 ## 🚀 **AFTER THE FIX**
 
 ### **Successful Build Output**
+
 ```
 📱 APK Details:
    Name: subtrackr.apk
@@ -95,6 +103,7 @@ npx expo prebuild --platform android --clean
 ```
 
 ### **Next Steps**
+
 1. **Test APK**: Install on device to verify functionality
 2. **Future Builds**: Use `./build.sh` for regular builds
 3. **Hackathon**: Share `builds/subtrackr.apk` with judges
@@ -104,24 +113,28 @@ npx expo prebuild --platform android --clean
 ### **If Fix Script Fails**
 
 #### **1. Check Java Version**
+
 ```bash
 java -version
 # Should be Java 11 or 17
 ```
 
 #### **2. Verify Android SDK**
+
 ```bash
 echo $ANDROID_HOME
 # Should point to Android SDK location
 ```
 
 #### **3. Check Node.js Version**
+
 ```bash
 node --version
 # Should be Node 16+ for Expo SDK 53
 ```
 
 #### **4. Clear Gradle Cache**
+
 ```bash
 cd android
 ./gradlew clean
@@ -132,17 +145,20 @@ cd ..
 ### **Common Error Messages**
 
 #### **"Permission Denied"**
+
 ```bash
 chmod +x fix-build.sh
 ./fix-build.sh
 ```
 
 #### **"Command Not Found: expo"**
+
 ```bash
 npm install -g @expo/cli
 ```
 
 #### **"Android SDK Not Found"**
+
 ```bash
 export ANDROID_HOME=$HOME/Library/Android/sdk  # macOS
 export PATH=$PATH:$ANDROID_HOME/platform-tools
@@ -151,26 +167,30 @@ export PATH=$PATH:$ANDROID_HOME/platform-tools
 ## 📱 **BUILD VERIFICATION**
 
 ### **APK Testing Checklist**
+
 - [ ] **Installation**: APK installs without errors
 - [ ] **Launch**: App opens without crashes
 - [ ] **Navigation**: All screens work properly
 - [ ] **Features**: Core functionality operates correctly
 - [ ] **Performance**: App responds smoothly
 
 ### **Device Compatibility**
+
 - **Android Version**: 5.0+ (API 21+)
 - **Architecture**: ARM64, x86_64
 - **Screen Sizes**: All standard Android sizes
 
 ## 🎯 **HACKATHON READY**
 
 ### **What You'll Have**
+
 - ✅ **Working APK**: `builds/subtrackr.apk`
 - ✅ **Professional Build**: Industry-standard process
 - ✅ **Easy Distribution**: Ready to share with judges
 - ✅ **Technical Excellence**: Demonstrates build expertise
 
 ### **Judging Impact**
+
 - **Problem Solving**: Shows ability to resolve technical issues
 - **Technical Depth**: Understanding of React Native build systems
 - **Professional Quality**: Production-ready build process
@@ -179,6 +199,7 @@ export PATH=$PATH:$ANDROID_HOME/platform-tools
 ## 🎉 **SUCCESS!**
 
 After running the fix script, you'll have:
+
 - **🔧 Resolved build issues** with Kotlin compilation
 - **📱 Working Android APK** ready for submission
 - **🚀 Professional build system** for future development
@@ -187,14 +208,17 @@ After running the fix script, you'll have:
 ## 🆘 **NEED HELP?**
 
 ### **Run the Fix Script**
+
 ```bash
 ./fix-build.sh
 ```
 
 ### **Check the Logs**
+
 The script provides detailed output for each step.
 
 ### **Manual Steps**
+
 Follow the manual fix guide if you prefer step-by-step control.
 
 ---