FreshLane

Open-source digital storefront starter for a local neighborhood supermarket — browse products, place online orders, click & collect or home delivery.

License: MIT · Maintainer: Santhi Prakash (@santhiprakash)

Quick Start

git clone https://github.com/santhiprakash/freshlane.git
cd freshlane
npm install
npm run dev

Open http://localhost:3000. No API keys required for the MVP (mock product data).

MVP Pages

• Customer: Home, Products, Categories, Offers, About, Contact, Cart, Checkout, Account, Orders
• Admin: Dashboard shell at /admin

Stack

Next.js 16 · TypeScript · Tailwind CSS · Mock data (Phase 2: Postgres + API)

Documentation

Doc	Purpose
PLANNING.md	Architecture, stack, design direction
PROGRESS.md	Change log and decisions
CONTRIBUTING.md	How to contribute
SECURITY.md	Vulnerability reporting
docs/DEVOPS.md	Deploy, env vars, hosting
docs/	Product & technical specs

Ownership

Role	Who
Repository owner	santhiprakash/freshlane (personal account)
Maintainer	@santhiprakash — see CODEOWNERS

This project is published under the personal GitHub account so the maintainer retains full admin access. A future transfer to an organization (e.g. GarudaCCS) is possible only after the maintainer has Maintain or Admin rights in that org.

Deploy

Demo: supermarket-neon.vercel.app — see docs/DEVOPS.md.

Contributing

See CONTRIBUTING.md. By participating you agree to the Code of Conduct.