🏘️ SocietyShare — The Neighborhood Asset Ledger

Platform: React Native CLI (Bare Workflow)
Theme: Soft Modern (Light)

---

⚠️ IMPORTANT: Windows Path Length Issue

If you're on Windows, React Native projects can fail to build when the project path is too long (>260 characters).

Solution: Move Project to Shorter Path

Your current path is very long due to OneDrive:

C:\Users\sharm\OneDrive\Documents\personal-projects\rentok\SocietyShare

Move the project to a shorter path like:

# Create a shorter path
mkdir C:\dev
cd C:\dev

# Move the project
Move-Item "C:\Users\sharm\OneDrive\Documents\personal-projects\rentok\SocietyShare" "C:\dev\SocietyShare"

# Navigate to new location
cd C:\dev\SocietyShare

Then try building again:

npm run android

---

🚀 Setup Instructions

1. Prerequisites

• Node.js: 18.x or newer
• Java JDK: 17
• Android Studio: With SDK installed
• ADB: Functioning and added to PATH

2. Run the App

# Install dependencies
npm install

# Start the Metro Bundler (Terminal 1)
npm start

# Run on Android (Terminal 2)
# Make sure your emulator is running or device is connected
npm run android

---

📂 Project Structure

SocietyShare/
├── App.tsx              # Main entry point & Home Screen
├── lib/
│   └── supabase.ts      # Backend connection
├── store/
│   └── useStore.ts      # Global state (Zustand)
├── android/             # Android native code
└── ios/                 # iOS native code

---

🎨 Features

• Soft Modern UI: #FAFAFA background, #FFFFFF cards, Soft Shadows
• Home Screen: Search, Categories, Feed with item cards
• Tech Stack: React Native CLI, Zustand, Supabase, Lucide Icons

---

🐛 Troubleshooting

Build fails with "Filename longer than 260 characters"

• Cause: Windows path length limitation
• Solution: Move project to C:\dev\SocietyShare (see above)

Metro bundler not starting

npx react-native start --reset-cache

Clean build

cd android
./gradlew clean
cd ..
npm run android

---

📦 Current Dependencies

• react-native: 0.76.0
• lucide-react-native: Icons
• zustand: State management
• @supabase/supabase-js: Backend
• react-native-gesture-handler: Touch interactions
• react-native-safe-area-context: Safe areas
• react-native-svg: SVG support

---

Built with ❤️ for safer, trust-based neighborhood sharing.