GramSetu

GramSetu is an Expo/React Native application built for rural agriculture communities. It combines local marketplace tools, labor matching, climate and crop insights, AI-assisted farming guidance, multilingual support, and Firebase-backed persistence for a polished mobile experience.

Key Features

• Mobile-first Expo app targeting Android, iOS, and web
• AI-powered chatbot for farmer assistance and guidance
• Labour marketplace with job listings, worker profiles, and applications
• Multilingual localization support for regional Indian languages
• Firebase integration for auth, data, and real-time updates
• Weather, market pricing, schemes, and climate information modules
• Admin panel support in admin-panel/

Technology Stack

• Expo Router + React Native
• Firebase (Firestore, Auth, Storage)
• TypeScript
• i18next for translations
• Expo location, camera, splash screen, and system UI
• AI integrations via Anthropic, Google GenAI, and local model fallback

Repository Structure

• app/ — Main Expo app screens and routes
• components/ — Reusable UI components and feature widgets
• services/ — Network, Firebase, AI, and data integration services
• data/ — Static prompts, mock data, translation helpers
• contexts/ — App state and localization context
• hooks/ — Custom React hooks
• i18n/ — Internationalization setup and locale files
• admin-panel/ — Browser-based admin interface
• docs/ — Feature and integration guides
• BUILD_INSTRUCTIONS.md — Production build and Firebase setup notes

Getting Started

Prerequisites

• Node.js 18+ or compatible runtime
• npm or yarn
• Expo CLI installed globally (npm install -g expo-cli)
• Firebase project with web credentials

Install Dependencies

cd d:/PROJECTS/GramSetu
npm install

Run Locally

npm run dev

This starts Expo in development mode. Use the Expo DevTools to open on Android, iOS, or web.

Build for Web

npm run build:web

Firebase Configuration

This project depends on Firebase credentials for production and many app features. See BUILD_INSTRUCTIONS.md for detailed setup.

At minimum, configure the following environment variables for local development or EAS builds:

• EXPO_PUBLIC_FIREBASE_API_KEY
• EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN
• EXPO_PUBLIC_FIREBASE_PROJECT_ID
• EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET
• EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID
• EXPO_PUBLIC_FIREBASE_APP_ID
• EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID

Available Scripts

• npm run dev — Start Expo development server
• npm run start — Start Expo development server
• npm run android — Open app on Android device/emulator
• npm run ios — Open app on iOS simulator
• npm run web — Start web version
• npm run build:web — Export web build
• npm run lint — Run Expo lint
• npm run clean — Clear Expo cache

Useful Docs

• BUILD_INSTRUCTIONS.md — Production build and environment setup
• docs/labor-marketplace-firebase-integration.md — Firebase labor marketplace integration details

Notes

• The project is currently configured as an Expo app with slug gramsetu and package com.gramsetu.app.
• The admin panel is available under admin-panel/ and has its own local setup.
• Keep Firebase secrets out of source control and use EAS secrets for production builds. "