Self-Hosted Mobile First Hyperlocal and Food Delivery Platform
Nearby Shops is a first of its kind decentralized, non-commercial, Open-Source and International Nonprofit E-commerce platform for local vendors.
This project is conceptually similar to Mastodon project. Anyone can self-host their Local Market Instance (Server) and create their local market. The technology is fully open-source and funded by Donations. We dont charge any fee or commission in order to use the platform.
Do you feel that we need a better e-commerce platform that values and treats people in a more humane manner ?
Please Help us improve the e-commerce and do your bit to make this world a better place !
We are looking for volunteers to help the platform. You can contribute as a developer, a content creator, digital marketer, Service Provider or in any other way you want to contribute !
Those Interested please contact us on https://forum.nearbyshops.org
Nearby Shops is an Open-Source food delivery, grocery and hyperlocal app platform. You can install your self-hosted instance on Digital Ocean or AWS and get your grocery or food delivery market up and running for just $ 5 per month in hosting fees.
Nearby Shops implements Alibaba's Grocery Online-to-Offline Concept. Customers can place and order from the app and pick it up in the store. Home Delivery is also available !
The installation guide and app customization guide is provided at http://developer.nearbyshops.org
Website : https://nearbyshops.org | Developers Guide: http://developer.nearbyshops.org
- Concept
- Tech Stack and App Architecture
- Features and highlights
- Libraries Used
- Third Party Integrations
- Connect with Us
- Contributions Required
- Contributor Compensation Program
- Development Instructions
- License
Nearby Shops is a Hyperlocal Shopping platform where a customer can buy directly from the shops available in his/her local area and get their orders delivered to their home or just pick the order up from the shop.
In the new emerging world, customers are getting tired of going outside the home to shop every day. They would much prefer to simply place an order and have the products delivered to their home the same day.
Conventional e-commerce has issues ... the delivery takes a long time and it's more difficult to trust unknown vendors whom you cannot see and meet. Hyperlocal e-commerce solves these issues because delivery is faster and customers can reach out to the vendors easily.
Nearby Shops can also be used as a food Delivery platform where restaurants can use it to deliver food.
Nearby Shops implements Alibaba's New Offline-to-Online Concept, where customers discover products online and then pick those products up from physical stores.
Uses Android Jetpack and Google’s Recommended Architecture Patterns - Migration to MVVM is planned
Written in both Java and Kotlin : Migration to kotlin is planned and will be coming in near future
Built using Butterknife, Retrofit, Ok-HTTP, Picasso, Dagger, and the Mapbox Android SDK
User-Interface is made using the modular View-Holder Pattern which makes the UI blocks modular, easy to reuse, modify and understand.
The app uses Single Activity Architecture, where most of the screens are implemented as fragments and there are only 2-3 activities in the entire project.
The project has 3 Android apps. One app each for the end-user, shop-owner and adminstrator. There is also a JSON-based REST API on the backend. The source-code for the REST API is provided.
Support for Multiple Currencies : You can set your locale and country and currency for your local market will be set accordingly.
Mobile First - Multi-Vendor Platform where customers can send orders to multiple Shops / Restaurants
Integrations for Sending SMS-OTP, E-mail and Push Notifications are available
Order Tracking, with live status updates for customers using E-mail, SMS and Push Notifications
Rating and Reviews for items and shops
Home delivery and pick-up from the shop (Online-to-Offline) Shopping Concept is Supported
Location based filtering is available, which means that customers will see only those shops which can deliver to their address -- other shops will be filtered out.
Vendors / Shop-Owners can track orders through orders inventory and update the order progress !
By adding delivery staff, shop-owners can deliver orders by themselves. Shared delivery logistics will also be available in future releases of Nearby Shops.
Billing and payments are supported. Shop-owners are billed according to the number of orders they deliver successfully. And Service Providers (Market Owners) can collect payments from the shop-owners.
Nearby Shops Multi-Market Mode - you can add your local market to nearby shops market discovery service and your market becomes visible and accessible to Global audience of Nearby Shops app. Read more about Nearby Shops multi-market mode !
Android-Jetpack, Retrofit, Ok-Http, Event-Bus, Picasso, butterknife, dagger2, U-Crop, Gesture Views, Smiley Rating, Mapbox Android SDK
SMS-OTP using MSG91 (More Integrations coming soon ...)
E-mail using Simple-Java-Mail E-mail Library
Push Notifications using Firebase and One-Signal
Maps using Mapbox Android SDK and Google Maps
Payment Gateway (Coming Soon ...)
If you want any help regarding anything. Feel free to contact us -- send a message through our forum or you can simply post an issue. Your issues will not be ignored and you will surely receive help.
Discourse Forum - https://forum.nearbyshops.org
Follow us Twitter - https://twitter.com/nearbyshopsapp
Facebook - https://www.facebook.com/nearbyshops
Facebook Group - https://www.facebook.com/groups/1144257952430940/
https://forum.nearbyshops.org/t/project-roadmap-and-contributions-required/34/4
Improved Search with Search Suggestions for android app
Develop a PWA and Web app for Nearby Shops
i18n Internationalization support
Payment Gateway Integrations
Performance Testing and Optimization
Suggestions and Improvements in App Architecture
Code Review and Architecture
We believe developer's must be compensated for the work they do.
How many times you have made a contribution to a project you love but havent received any compensation for that. Unfortunately unpaid working hours is the sad reality for many open-source developers ...
We want to change this ...Therefore we have launched contributor compensation scheme ! When you make a contribution to this project you will be paid at the rate of 10-15 $ per hour we can make it upto 50 $ per hour for contributors from countries where cost of living is high.
Please note that we reserve the right to accept or reject your contribution. You will be paid only if your contribution is accepted.
Ability to pay for contributions depend on availibilty of funds ... we recommend you to contact us and talk with us before you plan to make any contribution to this project.
If you're a developer looking to work on the source code follow these instructions to start developing !
git clone https://github.com/SumeetMoray/Nearby-Shops-End-User-Android-app.git
You should now open the project with the latest version of Android Studio.
Our goal is to provide an e-commerce platform which is technologically advanced, free of cost, open, democratic and Non-Commercial.
If you like this Idea and this project Please volunteer and Help us ! You can help us in various ways even if you do not know how to write code !
- Host an instance of Local market where other sellers could register. You will work as the administrator of your local market.
- Help us to Promote this project in your local community !
This is an International Platform with support for multiple curriencies. Please help us making e-commerce truly free of cost for everyone.
To participate please contact us on [email protected] or simply post your thoughts on our forum https://forum.nearbyshops.org
We pay the developers who contribute to this open-source project. This project is free for non-commercial use, experimentation, testing and trial purpose but commercial use requires Permission. For more information please visit https://nearbyshops.co
App Customization Permitted - You can whitelabel or customize the android app with your own branding using this customization guide. https://developer.nearbyshops.org/installation/customize-apps.html
Nearby Shops Open-Source License Copyright 2017-19 Bluetree Software LLP, Inc. | http://nearbyshops.org
Commercial Use of Nearby Shops open-source project must comply with our ethical guidlines. This is done to ensure that people dont use this software for unfair and unethical use. The kind of usage that promotes monopoly and destroys local business and fair competition in the economy.
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.