Retail Discovery Platform

Lagakade LK

A local retail store discovery platform for Sri Lanka that helps people search for a product, find nearby shops with stock, reserve it, and pick it up in person.

Client:CodePlus Global
Role:AI/ML Engineer - Freelancer
Domain:Retail & Local Commerce
Type:Discovery + Reservation Platform

Project Overview

A practical platform for discovering products through nearby physical stores

🔎

The Idea

Build a search-first retail platform that helps customers find items in stock near them instead of relying on delivery-heavy shopping flows.

🗺️

The Experience

Search products, view nearby shops, inspect the map, reserve the item, and walk in to pick it up — simple and local by design.

💳

The Business Model

Supports subscriptions, reservation flow, and store discovery so small retailers can surface inventory and customers can buy faster.

Delivery Timeline

From local discovery concept to a pickup-first retail platform

1

Define the shopping problem

Focused on a simple local behavior: users know what they want, but not which shop nearby has it in stock.

2

Build store discovery

Designed the product and map workflow so people can search, compare nearby stores, and understand availability fast.

3

Add reservation and messaging

Added the ability to reserve before visiting, backed by multilingual communication and email flows.

4

Launch commerce hooks

Subscriptions, payments, and operational tooling were added so shops could actually use the platform in practice.

Key Features

Features designed around local retail behavior

📦

Product Discovery

Customers search a product and immediately see stores that have it in stock nearby.

📍

Nearby Store Mapping

Leaflet and OpenStreetMap power a free map layer with no API key requirement.

🧾

Reservation Flow

Users can reserve an item before visiting the shop, keeping the process practical and low friction.

🌐

Trilingual UI

English, Sinhala, and Tamil support makes the system accessible across the Sri Lankan market.

📧

Email Automation

Brevo and SMTP fallback handle outgoing emails reliably without locking the product to one provider.

💎

Subscription Model

Lemon Squeezy supports Basic and Pro plans for businesses using the platform.

Architecture

Search, geo, commerce, and communication layers working together

1

Search experience

The customer-facing flow begins with search and quickly narrows into store and stock discovery.

  • Search product by name or category
  • Show nearby matching stores
  • Lead the user toward reservation
2

Geo and inventory layer

PostGIS and GeoAlchemy2 power the store radius logic while the store inventory data stays queryable at scale.

  • Map-based store lookup
  • Distance-aware nearby results
  • Pickup-first commerce logic
3

Commerce services

Subscriptions, email delivery, scheduling, and authentication keep the product operational for real merchants.

  • FastAPI business APIs
  • Brevo email delivery with SMTP fallback
  • Lemon Squeezy subscription handling

Technology Stack

Frontend, backend, geo and commerce tools

💻Frontend

Next.js 15React 19TypeScriptTailwind CSSnext-intlLeaflet

🗄️Backend

FastAPIPython 3.11SQLAlchemy 2PostgreSQLPostGISRedisJWT

🧰Integrations

OpenStreetMapGeoAlchemy2BrevoLemon SqueezyAPScheduler

Outcomes

Why the platform matters for both shoppers and retailers

3

Languages supported

Built for English, Sinhala, and Tamil so more Sri Lankan shoppers can use it comfortably.

0

Map API dependency

The map experience avoids paid map APIs by using Leaflet and OpenStreetMap.

1

Pickup-first flow

The entire product is optimized for reservation and in-person collection rather than delivery logistics.

Product Scope

A local commerce platform built for discovery and pickup

3Languages
0Map API Key Needed
2Subscription Plans
1Pickup-First Flow

Building a commerce platform?

I can help shape the product, frontend, backend, and deployment flow.

Contact Me View More Projects