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