As we figured out the first version needed some necessary improvements and therefore we are delaying the release

…  So please stay tuned and patient … and check again later …

The development is under progress we will be launching Soon !

Nearby Shops is an open source location based e-commerce software with support for both mobile and web

Nearby Shops helps people buy items like fruits, vegetables and grocery from shops located near to them and even get a home delivery of the items they have purchased.

Shopping from local markets is a highly localized experience and not the same as buying from a typical e-commerce store. Therefore local shopping needs location based features. Which might involve location based filtering based on your pincode or Latitude | Longitude obtained from GPS.


Technical Concerns we faced while development

Shops like fruit shop and vegetable shop typically delivery only to an area of say 4 kms or 5 kms. So not every fruit shop located in your city will deliver at your location.

We allow each shop to define a delivery range.

Therefore we needed some kind of location based filtering so that customers can see only those items which can be delivered on their location.

Localized shopping needs location based filtering. Which can be typically done through either PINCODE or Latitude | Longitude

On this website we provide all the tutorials and support to set your service up and running without you requiring any knowledge of programming and coding.


Bussiness Model

Nearby Shops Software is open source and planned to be backed by a Nonprofit so that we can ensure everyone gets the full freedom to use and customize the software the way they want to.


Technology Stack : Nearby Shops is Built with

Backend Side : At the backend we have a REST API built with

Postgres 9.6 and above [ Primary Database ]


Jersey [ an Implementation of JAX-RS]

Jetty [ an embedded server for Java ]

JDBC [ for making database calls ]

Hikari CP [ for connection pooling ]

Maven [ Build Tool we used – you can use gradle also instead of maven ]

GSON [ for converting JSON to objects and vice-versa ]

thumbnailator [ a library for generating thumbnails ]

Ok-Http [ for making network calls ]

Mailgun [ for sending emails ]

Jodatime [ a library for data and time in java ]

We havent used an ORM (Object Relational mapping) tool as we had been adviced against it and we didnt felt the need.

Frontend : at the font end we have android apps which consume the REST API

Minimum Requirements

You can deploy the Nearby Shops backend on any clould server (digital ocean, amazon ec2, rackspace, azure) with 1 GB RAM.



Features In Detail

Permissions for Staff Members

Shop Administrators / Shop Owners can add staff members and assign each staff members permissions relevant / required specifically suited for their roles.


Push Notifications for Shops and End-Users : Shops and Users 

Shops get notifications whenever they receive an order from a customer and customers also get notifications which notifies them about the progress of the app.



Monitor Stock with a Quick Stock Editor

Quick Stock Editor will show you items which have become out of stock. It provides easy to monitor assistance for monitoring the stock of items in the Shop.



Location Based Delivery Assistance for Delivery Guy’s

The app provides location based assistance to the Delivery Guy. This includes route guidance and navigation to the customers addresses. And sorting the Customers Home address by distance. This helps delivery Guy deliver the orders in less amount of time and with much less pain.



Ability to Define Delivery Range for Shops

Shops can define a delivery range for themselves. This ensures that they will receive orders only from customers who fall under their delivery range. Shops will not receive orders from Customers who fall outside the delivery Range of the Shop.


Frequently Asked Questions (FAQ’s)

General FAQ’s

What is Nearby Shops ? 

Nearby Shops is an Open-Source software which helps you build your mobile app / website for local shopping . It includes both the server and front end.

A local e-commerce website / mobile app helps you buy items like fruits, vegetables and grocery from shops located near to you.

Local ecommerce differs from the typical e-commerce in a way that both the buyer and the seller are situated in the same city.

Nearby Shops also act like a “Yellow Pages” for Shops and Local Business. It can show the customers the shops located near to them and help the shop’s advertise their shops to the customers.


What is a Business Model of the Nearby Shops Software ? 

Nearby Shops software is supported by a Nonprofit Foundation which is funded exclusively by donations from supporters and well wishers.

Nearby Shops platform is an ecosystem of Independent services each managed by independent entrepreneurs.


FAQ’s for Developers and Code Contributors 

Can I contribute to the Nearby Shops Open – Source Project ?

Yes sure why not ! You are welcome to contribute and help us improve the software.

Nearby Shops is available on GitHub so you can use github platform to contribute.

If we see the contribution you are providing is helping the original Purpose of Nearby Shops Software we will be happy to accept your contribution in the Original GitHub Repository.

But if “we think / Feel” your contribution does not help the original Purpose of the Nearby Shops Software we will still try to include your feature as an experimental feature.

Are there any specific features where you require contribution ? 

Yes sure,

We require contribution for these specific features

  1. Develop a web app for Nearby Shops API
  2. Add TLS/ SSL Support
  3. Full Text Search with Search Suggestions
  4. Google and Facebook Sign-In


FAQ’s for Server / System Administrators

Do you have to pay for using Nearby Shops Software ? If Yes how much ? 

Nearby Shops is an Open- Source Software and which is available free of cost for everyone. You don’t have any *legal* obligation to pay for using the software. But if you do wish to help the project you can surely consider donating and helping the Project financially.

How can I Install Nearby Shops Software and Start Using it ? 

The installation guide for installing the Nearby Shops API is available in the Tutorials Section for Server Administrators

What kind of skills do I need to have in order to install and use Nearby Shops Software Back-end and Front-End ?

For Installing the Backend you need to have Ubuntu – Linux Server Administration skills . You are expected to have basic knowledge of using Linux / Ubuntu terminal commands.

We have successfully installed and tested Nearby Shops API on Ubuntu 16.04 Server’s on Digital Ocean Cloud Hosting Service. Therefore we have better experience with this server configuration and we recommend System Administrators to use the same configuration while installing the API on your system.

We are very happy and satisfied with Digital Ocean and we recommend People to use their services. This is our independent opinion and we have not taken any sponsorship from Digital Ocean for giving this opinion.

What is the Technology / Software Stack for the Nearby Shops ?

Nearby Shops is made Entirely in Java using Java Language. The Nearby Shops API is a java based REST API developed using Jersey – JAX-RS framework.

At the Backend – Nearby Shop API is a java Based REST API which utilises Postgres Database as a Backend Database.

The Front End – of the Nearby Shops is Android App. The android app is a native app made in Java using latest Android SDK’s.

We believe in Open-Source philosophy and therefore we made sure that we use and adopt open-source software wherever we can even at the time of development. Nearby Shops is developed on Machines installed with Ubuntu OS (Operating System). Using an Open Source Android Studio IDE provided by Google based on Intellij Idea.

We have also used Inkscape (Open Source Vector Image Editing Software) and GIMP (Open Source Image Editing Software) for editing all the graphics available in the Nearby Shops android App.