ReFreshly Web

The Growth & Acquisition Portal for Kazakhstan's Food Waste Marketplace

System Overview

This repository hosts the consumer-facing web portal for the ReFreshly ecosystem.

As the primary touchpoint for our seed-funded initiative ($20k), this codebase prioritizes Zero-Latency Localization and Smart Device Routing to maximize partner and user onboarding in the bilingual Almaty market.

Growth Engineering Architecture

We architected the frontend to serve two distinct user personas (B2C Customers & B2B Partners) with a focus on conversion rate optimization (CRO).

1. Intelligent Traffic Routing

To drive app installs, the platform utilizes User-Agent heuristics to dynamically reconfigure Call-to-Action (CTA) paths:

• iOS Traffic: Deep links directly to the App Store.
• Android Traffic: Routes to Google Play.

2. Zero-Latency Localization (i18n)

Full localization support was architected to ensure feature parity and SEO performance in both Russian and English.

• Dynamic Metadata: SEO tags and page titles update synchronously with language state to preserve search indexing.
• Persistent State: User preference is cached to ensure continuity across the acquisition flow.

3. Serverless Lead Pipeline

For B2B Partner onboarding (restaurants), we bypassed traditional backend overhead by integrating a serverless EmailJS pipeline. This allows for instant lead capture and CRM injection directly from the client side, reducing infrastructure costs while maintaining high reliability.

The Tech Stack

Domain	Technologies
Core	React 18, TypeScript, Vite
UX & Physics	Framer Motion (Scroll-linked animations)
Styling System	Tailwind CSS, Shadcn UI (Primitives)
Internationalization	i18next, react-i18next
State Management	React Hooks (Local), TanStack Query (Server)

Local Development

To spin up the acquisition portal locally:

1. Clone the Repository

   git clone https://github.com/alexandr-tk/refreshly-web.git
   cd refreshly-web

2. Install Dependencies

   npm install

3. Environment Configuration Create a .env file to link the serverless email pipeline:

   VITE_EMAILJS_SERVICE_ID=your_service_id
   VITE_EMAILJS_TEMPLATE_ID=your_template_id
   VITE_EMAILJS_PUBLIC_KEY=your_public_key

4. Launch

   npm run dev

Contact & Ecosystem

Alex Tkachyov - Co-Founder & CTO

• Ecosystem: ReFreshly Mobile (iOS/Android)
• Connect: LinkedIn

License

© 2026 ReFreshly. All rights reserved. This repository is public for educational and portfolio purposes. Commercial usage, modification, or distribution of this code is strictly prohibited.