GoLocal - Shop Local, Support Local 🛒📍

Connecting communities by bringing neighborhood stores to your fingertips.

GoLocal is a hyperlocal marketplace application designed to empower local retailers and provide customers with the convenience of online shopping from their trusted nearby stores. By digitizing the inventory of kirana stores, grocery shops, and local vendors, we aim to sustain local economies and reduce the reliance on big-box retail.

🔗 Official Website: https://www.golocal.page

---

📱 Table of Contents

• Mission
• Key Features
  • For Shoppers
  • For Shop Owners
• Tech Stack
• Screenshots
• Installation
• Contributing
• Contact

---

🎯 Mission

"Shop Local, Support Local" is not just our tagline; it's our core philosophy.

• For Customers: Convenience, trust, and faster delivery (often < 2 hours).
• For Sellers: A zero-cost entry into the digital market to compete with giants.
• For the Community: Keeping money within the local ecosystem creates jobs and growth.

---

🌟 Key Features

For Shoppers (Users)

• 📍 Location-Based Discovery: Automatically find stores within a 5km radius.
• 🛒 Seamless Ordering: Browse catalogs, add items to cart, and checkout in clicks.
• 📦 Real-Time Tracking: View order status from "Accepted" to "Out for Delivery."
• 💬 Direct Chat: Chat with shop owners for specific requirements.
• 💸 Secure Payments: Options for UPI, Credit/Debit Cards, or Cash on Delivery (COD).

For Shop Owners (Vendors)

• 🏪 Digital Storefront: Set up a shop profile in under 2 minutes.
• 📋 Inventory Management: Easy tools to add products, set prices, and manage stock.
• 🔔 Order Alerts: Instant notifications for new orders to ensure quick processing.
• 📊 Sales Dashboard: Track daily earnings and popular products.

---

🛠 Tech Stack

The project is built using robust modern technologies to ensure scalability and performance.

• Mobile App: Kotlin (Android Native) / Jetpack Compose
• Backend: Firebase (Firestore, Auth, Cloud Functions)
• Payment Gateway: Razorpay / Stripe Integration
• Maps: Google Maps SDK for location services
• Design: Material Design 3

---

📸 Screenshots

Home Screen	Store Listing	Product Page	Cart & Checkout

---

🚀 Installation

To run the application locally, follow these steps:

1. Clone the repository:

   git clone [https://github.com/your-username/golocal-android.git](https://github.com/your-username/golocal-android.git)
   cd golocal-android

2. Open in Android Studio:

   • Launch Android Studio.
   • Select "Open an Existing Project" and point to the cloned folder.

3. Firebase Setup:

   • Create a project on the Firebase Console.
   • Download the google-services.json file.
   • Place it in the app/ directory.

4. Build and Run:

   • Sync Gradle files.
   • Connect a physical device or start an emulator.
   • Click the Run button (▶).

---

🤝 Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

📞 Contact

Project Lead - [Satya prakash] Email: customersupport@golocal.page Project Link: https://github.com/satya7667444593/golocal