Shoppy

A smart shopping list app built with Expo and React Native that uses LLM-powered clustering to organize items by category.

Features

• Smart Clustering - Automatically organizes items into categories (Produce, Dairy, Meat, etc.) using AI
• Recipe Suggestions - Describe a dish and get ingredient suggestions added to your list
• Purchase History - Track past shopping trips and re-add items quickly
• Statistics - View your most bought items and shopping patterns
• Fuzzy Autocomplete - Quick item entry based on your purchase history
• Offline-First - All data stored locally on device

Getting Started

Prerequisites

• Node.js 18+
• Expo CLI
• Android device or emulator

Installation

# Install dependencies
npm install

# Start the development server
npm start

Configuration

1. Open the app and go to Settings
2. Enter your OpenRouter API key
3. Select your preferred LLM model

Tech Stack

• Framework: Expo SDK 54 with Expo Router
• Styling: NativeWind (Tailwind CSS)
• Storage: AsyncStorage
• Search: Fuse.js
• AI: OpenRouter API

Build

Development Build

npx eas-cli build --platform android --profile development

Internal Distribution (APK)

npx eas-cli build --platform android --profile preview

Production Build

npx eas-cli build --platform android --profile production

Project Structure

app/                  # Expo Router pages and layouts
  (tabs)/             # Tab navigation screens
components/           # Reusable UI components
hooks/                # Custom React hooks
services/             # API calls, storage, business logic
types/                # TypeScript interfaces
constants/            # App constants
utils/                # Utility functions

License

Private project - All rights reserved